Moon phases

GET/moon-phasesRESTFrom Business

Get moon phases with Human Design gate positions.

Combine lunar phase timing with gate and line data for calendars, rituals and content experiences.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

NameInRequiredDescription
Idempotency-KeyheaderNoStrongly recommended stable 8–160 character key for consuming operations. Reuse it only when retrying the same request; without it, the API cannot deduplicate a lost-response retry.
hdai-example-19900515
X-Api-KeyheaderYesAPI key used by the authorization middleware.
YOUR_API_KEY
YearqueryYesCalendar year.
2026
MonthqueryYesCalendar month from 1 to 12.
8
TimezonequeryNoIANA timezone.
UTC

Quota effect

A valid authorized execution uses exactly 1 calculation unit immediately before the calculation provider is reached. Invalid input, unresolved references, unsupported detail levels, and denied tiers use 0 units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations