get

/api/v1/moon/next

Get next occurrence of a Moon phase

Overview

Returns the date of the next occurrence of a specified Moon phase.

Parameters

NameTypeInRequiredDescription
phasestringqueryYes

The Moon phase to find

Allowed:
New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent
fromstringqueryNo

Start date for search (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ). Defaults to today.

Response

200 — Next occurrence of the specified phase

phase string required
Enum:
New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent
illumination number required
Percentage of Moon illuminated
date string required
ISO date string

Example Request

cURL
curl "https://api.almuten.io/api/v1/moon/next" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "phase": "New Moon",
  "illumination": 75.5,
  "date": "2025-11-26"
}