calendar

8-Phase Lunar Classification + Next Principal Phases

Returns the current 8-phase lunar phase classification (not just 4), illumination fraction, Moon age in hours, and the next 4 principal phase moments (New, First Quarter, Full, Third Quarter). 🤖 AI-optimized output available — add format=llm to reduce payload ~45%. Pricing: 2 credits — one 30-day lunar cycle (at most 4 exact phase events): the cheapest way to get the exact time of the next New, First Quarter, Full or Third Quarter Moon.

get/calendar/astrology/moon-phases

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/calendar/astrology/moon-phases
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

datestring nullable

Date in YYYY-MM-DD format. Mutually exclusive with jd.

jdnumber double nullable

Julian Day. Mutually exclusive with date.

formatstring nullable

Response format: json | llm.

Response

Current phase and upcoming principal phases

_metaobject required

Calculation metadata

rangeobject required

Start and end dates of the search

Changes

No recorded changes to this operation across all 1 revision of this API.