🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Lunar Metrics

The lunar_metrics API provides information about the Moon, including its distance from Earth and whether it is within its apogee or perigee range. The response includes the date of the measurement, whether the Moon is within its perigee range, the distance between the Moon and Earth, whether the Moon is within its apogee range, and the apogee distance between the Moon and Earth.
POSThttps://json.astrologyapi.com/v1/lunar_metrics

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

dayintrequired

Date of birth, eg: 10

monthintrequired

Month of birth, eg: 5

yearintrequired

Year of birth, eg: 1990

hourintrequired

Hour of birth, eg: 19

minintrequired

Minute of birth, eg: 55

latfloatrequired

Latitude, eg: 19.2056

lonfloatrequired

Longitude, eg: 25.2056

tzonefloatrequired

Timezone, eg: 5.5

house_typestringrequired

Default : placidus // koch/topocentric/poryphry/equal_house/whole_sign

← Previous
Sun/Rising Compatibility
Next →
Moon Phase Report
curl --location 'https://json.astrologyapi.com/v1/lunar_metrics' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "day": 10,
    "month": 5,
    "year": 1990,
    "hour": 19,
    "min": 55,
    "lat": 19.2056,
    "lon": 25.2056,
    "tzone": 5.5,
    "house_type": "placidus"
}'
Try it

Runs with sample data — no API key needed

{
  "month": "10-5-1990",
  "within_perigee_range": false,
  "distance": "--",
  "within_apogee_range": true,
  "apogee_distance": 406431,
  "moon_sign": "Scorpio",
  "moon_phase": "Full Moon",
  "moon_age_in_days": 15.470096481335087,
  "moon_day": 16,
  "moon_illumination": 99
}