get

/api/v1/moon/phase

Get Moon phase

Overview

Returns the current Moon phase, illumination percentage, and date.

Parameters

NameTypeInRequiredDescription
datestringqueryNo

Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.

timezonestringqueryNo

IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

Response

200 — Moon phase information

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

Example Response

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