Moon Phase

Get Moon Month

Get a full calendar month of moon snapshots.

Each entry in days mirrors the /phase payload for that calendar date. When a location is provided, the snapshot is taken at local midnight for that calendar day.

get/api/v1/moon/month

Request

  • Base URL: https://api.freeastroapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.freeastroapi.com/api/v1/moon/month
  • Auth: none declared

Query parameters

yearinteger required

Astronomical year for the month (supported range: 0-2399; year 0 = 1 BCE)

monthinteger required

Calendar month number (1-12)

citystring nullable

City name for coordinate lookup (alternative to lat/lon)

latnumber nullable

Latitude for rise/set times

lonnumber nullable

Longitude for rise/set times

tz_strstring

Timezone string for local calendar sampling. Use AUTO to resolve from city/lat/lon.

style_moon_colorstring

SVG fill color for the moon (hex)

style_shadow_colorstring

SVG fill color for the shadow (hex)

include_zodiacboolean

Include zodiac sign information

include_rise_setboolean

Include rise and set times

include_visualsboolean

Include SVG visuals and shadow ratio

include_specialboolean

Include special moon types (supermoon, blue moon, etc.)

include_eclipseboolean

Check for a solar or lunar eclipse on or near each date

include_forecastboolean

Include days until next phases and special moons, plus next lunar and solar eclipses

include_interpretationboolean

Include psychological/spiritual moon interpretation based on sign, phase, and decan

include_traditional_moonboolean

Include the traditional full moon name from the North American naming system, for the current full moon or the next upcoming full moon

include_sign_timelineboolean

Include the Moon's sign ingress timeline across the requested month, with start/end times and durations for visual timeline rendering

Response

Successful Response

yearinteger required
monthinteger required
month_namestring required
days_in_monthinteger required
calendar_basisstring required
calendar_timezonestring required

Changes

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