Moon phase API playground
First Quarter, 48.46% lit at 2026-10-18T12:00:00.000Z.
Live request
/api/v1/moon?date=2026-10-18&time=12%3A00&tz=UTC&lat=51.5074&lon=-0.1278
Version 1 input and units
GET /api/v1/moon accepts one ISO date,24-hour time and named time zone. Latitude and longitude are optional together, in degrees north and east. Requests need no account or key; this version imposes no application quota. Send single dates here and bounded ranges to the exporter. Invalid values return 400 with an error message.
| Field | Unit or convention |
|---|---|
| illuminationFraction | 0–1 illuminated fraction |
| phaseAngleDegrees | Sun–Moon ecliptic elongation,0–360° |
| lunarAgeDays | Elapsed24-hour days since conjunction |
| geocentricDistanceKm | Earth–Moon centre distance in kilometres |
| position.altitude | Refracted horizon altitude in degrees |
| position.azimuth | Degrees clockwise from true north |
| civilDayEvents | Rise, set and transits clipped to the selected local date |
| instantUtc | UTC timestamp; local dates depend on the selected zone |
Use the ephemeris exporter for ranges up to 1000 samples. Position requires both observer coordinates; geocentric lunar facts remain global.
Try a date, time and location; inspect the returned Moon phase, position and rise/set fields with a live request.