get

/api/v1/moon/phases

Get Moon phases for a month

Overview

Returns all major Moon phases (New, First Quarter, Full, Last Quarter) for a specified month.

Parameters

NameTypeInRequiredDescription
yearstringqueryYes

Year (YYYY)

monthstringqueryYes

Month (1-12)

Response

200 — Moon phases for the month

year number required
month number required
phases array required

array of object

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/phases" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "year": 0,
  "month": 0,
  "phases": [
    {
      "phase": "New Moon",
      "illumination": 75.5,
      "date": "2025-11-26"
    }
  ]
}