apyhub

Get Natal Moon API

What it does

Moon Phase Lookup returns the moon phase, moon sign, illumination, and elongation for a given moment in time. Pass a birth_utc date-time to get a natal reading, or leave it out entirely to get a snapshot of the Moon right now — no input required.

The response includes moon_phase as one of New Moon, First Quarter, Full Moon, or Last Quarter, plus moon_sign across the twelve zodiac signs, along with illumination_pct and elongation_deg so you don't have to do the astronomy math yourself.

Use it when you need to classify a birth record by lunar conditions, add astrology-flavoured context to a profile, power a birth summary or wellness report, or simply want "what's the Moon doing right now" with zero setup.

GET
Get Natal Moon
http://localhost:8080/creightonnick0/get-natal-moon/v1/lunar/natal-moon

QUICKSTART

GUIDE

Quickstart

Get the current Moon's phase and sign with no input:

curl -X GET "http://localhost:8080/creightonnick0/get-natal-moon/v1/lunar/natal-moon" \
  -H "apy-token: $APY_TOKEN"

Or pass a birth time for a natal reading:

curl -X GET "http://localhost:8080/creightonnick0/get-natal-moon/v1/lunar/natal-moon?birth_utc=1990-06-15T14%3A30%3A00%2B00%3A00" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

{
  "birth_utc": "1990-06-15T14:30:00+00:00",
  "moon_phase": "Last Quarter",
  "moon_sign": "Pisces",
  "illumination_pct": 56.5,
  "elongation_deg": 262.52
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Optional. Defaults to the current UTC time if omitted.

About this endpoint

What it does

Returns the Moon phase, zodiac sign, illumination percentage, and elongation for the given moment. If birth_utc is omitted, the current UTC time is used.

Query Parameter(s)

AttributeTypeMandatoryDescription
birth_utcStringNoDate/time in UTC (date-time format). Defaults to the current moment if omitted.

Response

Returns a JSON object with birth_utc as a String, moon_sign as a String, moon_phase as a String, elongation_deg as a Number, and illumination_pct as a Number.

ParameterTypeMandatoryDescription
birth_utcStringYesThe moment used for the calculation (echoes input, or current time if none was given).
moon_signENUMYesAllowed values: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces.
moon_phaseENUMYesAllowed values: New Moon, First Quarter, Full Moon, Last Quarter.
elongation_degNumberYesMoon elongation in degrees. Range: 0 to 360.
illumination_pctNumberYesMoon illumination percentage. Range: 0 to 100.

Query parameters

Name
Type
Description
birth_utcOPTIONAL
string
Optional. Defaults to the current UTC time if omitted.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Product
CatalogPricingQuickstartBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS