Moon phase, illumination and the next new and full moons

GET/v1/moon

Moon phase, illumination and the next new and full moons

datequery · string

Date or ISO-8601 instant (default now)

e.g. 2026-10-08

latquery · number

Latitude, for moonrise and moonset

e.g. -90

lonquery · number

Longitude, for moonrise and moonset

e.g. -180

tzquery · string

IANA zone for local times

e.g. string

curl "https://api.apialmanac.com/v1/moon" \
  -H "X-API-Key: YOUR_KEY"

import requests

r = requests.get("https://api.apialmanac.com/v1/moon", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.apialmanac.com/v1/moon", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

{
  "at": "2026-10-08T12:00:00Z",
  "phase": "Waning Crescent",
  "phase_fraction": 0.91,
  "illumination": 0.08,
  "age_days": 26.9,
  "waxing": false,
  "next_new_moon": "2026-10-10T15:50:00Z",
  "next_full_moon": "2026-10-26T04:12:00Z",
  "moonrise": null,
  "moonset": null
}