---
title: "Get Moon Phase"
method: GET
path: "/api/v1/moon/phase"
tags: ["Moon Phase"]
---

# Get Moon Phase

`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

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

## Query parameters

- `date` string, nullable: ISO datetime (YYYY-MM-DDTHH:MM:SS), defaults to now. Supported years: 0000-2399.
- `city` string, nullable: City name for coordinate lookup (alternative to lat/lon)
- `lat` number, nullable: Latitude for rise/set times
- `lon` number, nullable: Longitude for rise/set times
- `tz_str` string: Timezone string for interpreting naive datetimes and local outputs. Use AUTO to resolve from city/lat/lon.
- `style_moon_color` string: SVG fill color for the moon (hex)
- `style_shadow_color` string: SVG fill color for the shadow (hex)
- `include_zodiac` boolean: Include zodiac sign information
- `include_rise_set` boolean: Include rise and set times
- `include_visuals` boolean: Include SVG visuals and shadow ratio
- `include_special` boolean: Include special moon types (supermoon, blue moon, etc.)
- `include_eclipse` boolean: Check for a solar or lunar eclipse on or near this date
- `include_forecast` boolean: Include days until next phases and special moons, plus next lunar and solar eclipses
- `include_interpretation` boolean: Include psychological/spiritual moon interpretation based on sign, phase, and decan
- `include_traditional_moon` boolean: Include the traditional full moon name from the North American naming system, for the current full moon or the next upcoming full moon

## Response `200`

Successful Response

- MoonPhaseResponse
  - `timestamp` string, required
  - `phase` MoonPhaseData, required
    - `name` string, required
    - `phase_angle_deg` number, required
    - `illumination` number, required
    - `age_days` number, required
    - `distance_km` number, required
    - `is_waxing` boolean, required
  - `zodiac` ZodiacData
    - `sign` string, required
    - `sign_id` string, required
    - `degree` number, required
    - `zodiac_type` string
  - `rise_set` RiseSetData
    - `rise` string, nullable, required
    - `set` string, nullable, required
    - `rise_local` string, nullable
    - `set_local` string, nullable
    - `location` string, nullable
    - `timezone` string
    - `timezone_local` string, nullable
  - `moon_visual` MoonVisualData
    - `type` string
    - `svg` string, required
    - `shadow_ratio` number, required
    - `waxing` boolean, required
  - `special_moon` SpecialMoonData
    - `is_supermoon` boolean
    - `is_micromoon` boolean
    - `is_blue_moon` boolean
    - `is_black_moon` boolean
    - `is_harvest_moon` boolean
    - `is_hunter_moon` boolean
    - `labels` string[]
  - `eclipse` EclipseData
    - `is_eclipse` boolean
    - `is_blood_moon` boolean
    - `kind` string, nullable
    - `type` string, nullable
    - `date` string, nullable
    - `starts_at` string, nullable
    - `ends_at` string, nullable
    - `central_phase_starts_at` string, nullable
    - `central_phase_ends_at` string, nullable
    - `visibility` string, nullable
    - `visible_at_location` boolean, nullable
    - `type_at_location` string, nullable
    - `days_from_query` number, nullable
    - `magnitude` number, nullable
    - `obscuration` number, nullable
    - `maximum_location` EclipseMaximumLocationData
      - `lat` number, required
      - `lon` number, required
    - `local_starts_at` string, nullable
    - `local_maximum_at` string, nullable
    - `local_ends_at` string, nullable
    - `magnitude_at_location` number, nullable
    - `obscuration_at_location` number, nullable
  - `forecast` object, nullable
  - `interpretation` MoonInterpretationData
    - `key` string, required
    - `title` string, required
    - `body` string, required
    - `tone` string, nullable
    - `tags` string[]
  - `traditional_moon` TraditionalMoonData
    - `name` string, required
    - `naming_system` string
    - `month` string, required
    - `applies_to_full_moon_at` string, required
    - `is_current_full_moon` boolean
  - `next_phases` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)