Moon Phase

Get Moon Phase

Get detailed moon phase data with optional verbosity.

Optional features:

  • include_zodiac: Moon's zodiac sign position
  • include_rise_set: Moon rise/set times (requires lat/lon)
  • include_visuals: SVG visualization of moon phase
  • include_special: Supermoon, Blue Moon, Harvest Moon, etc.
  • include_eclipse: Solar and lunar eclipse detection within 15 days
  • include_traditional_moon: Traditional full moon name with explicit naming-system scope
get/api/v1/moon/phase

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/phase
  • Auth: none declared

Query parameters

datestring nullable

ISO datetime (YYYY-MM-DDTHH:MM:SS), defaults to now. Supported years: 0000-2399.

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 interpreting naive datetimes and local outputs. 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 this 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

Response

Successful Response

timestampstring required
forecastobject nullable
next_phasesobject required

Changes

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