Authorization Required

Moon Phase

Lunar Phase Calculator — No External APIs

Calculate precise moon phase data mathematically using a synodic period of 29.53058867 days. Returns current phase, illumination %, moon age, zodiac sign, approximate distance, and next full/new moon dates. Every response automatically includes a 30-day lunar calendar starting from the target date under calendar_30_days.

Endpoint

GEThttps://space.veerexa.com/api/v1/astronomy/moon

Parameters

Name	Type	Status	Description
date	Query	Optional	Target date (YYYY-MM-DD). Defaults to today.
include_calendar	Query	Optional	Set to "true" to include a customizable, extended lunar calendar in the response.
calendar_from	Query	Optional	Calendar start date (YYYY-MM-DD). Default: 30 days ago.
calendar_to	Query	Optional	Calendar end date (YYYY-MM-DD). Default: 365 days ahead. Max range: 395 days.

Request Snippet

curl -X GET "https://space.veerexa.com/api/v1/astronomy/moon?date=value&include_calendar=value&calendar_from=value&calendar_to=value" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Sample

{
  "data": {
    "date": "2026-06-06",
    "phase": "Waning Gibbous",
    "emoji": "🌖",
    "age": 21.03,
    "illumination": 62,
    "next_full_moon": "2026-06-29",
    "next_new_moon": "2026-06-15",
    "zodiac_sign": "Taurus",
    "distance_km": 383671,
    "cycle_progress": 0.7121,
    "days_until_full_moon": 23,
    "days_until_new_moon": 9,
    "calendar_30_days": [
      {
        "date": "2026-06-06",
        "phase": "Waning Gibbous",
        "emoji": "🌖",
        "age": 21.03,
        "illumination": 62
      }
    ]
  },
  "calendar_30_days": [
    {
      "date": "2026-06-06",
      "phase": "Waning Gibbous",
      "emoji": "🌖",
      "age": 21.03,
      "illumination": 62
    }
  ],
  "meta": {
    "calculation_method": "Mathematical (Synodic period: 29.53058867 days)",
    "reference_new_moon": "2000-01-06",
    "api_version": "v1"
  }
}