About this endpoint
What it does
Returns a full calendar-year payload for the requested year, timezone, and hemisphere, including moon phases, moon sign ingresses, sabbats, planetary events, and a verification string. The request takes the year as a path parameter and accepts optional query parameters for timezone and hemisphere.
Path Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| year | String | Yes | The calendar year to render. |
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| tz | String | No | IANA timezone name. If requested, it is returned as tz; otherwise the response tz is null. |
| hemisphere | ENUM | No | Hemisphere used for the rendered year.<br>- north<br>- south<br>Default: north |
Response
Returns a JSON object with year (integer), hemisphere (string enum), tz (string or null), moon_phases (array), moon_signs (array), planetary_events (array), sabbats (array), and verified (string) fields. The response is the full year payload for the requested configuration.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| year | Integer | Yes | The rendered calendar year. |
| hemisphere | ENUM | Yes | The hemisphere used in the response.<br>- north<br>- south |
| tz | String | Yes | IANA timezone name if requested; otherwise null. |
| moon_phases | Object Array | Yes | Moon phase events. Each item includes phase and exact_utc. phase is one of:<br>- new<br>- first_quarter<br>- full<br>- last_quarter |
| moon_signs | Object Array | Yes | Moon sign ingress events. Each item includes sign and ingress_utc. sign is one of:<br>- Aries<br>- Taurus<br>- Gemini<br>- Cancer<br>- Leo<br>- Virgo<br>- Libra<br>- Scorpio<br>- Sagittarius<br>- Capricorn<br>- Aquarius<br>- Pisces |
| planetary_events | Object Array | Yes | Planetary and seasonal events. Each item includes kind, body, exact_utc, and detail. kind is one of:<br>- cross_quarter<br>- solar<br>- equinox<br>- solstice<br>- retrograde_start<br>- retrograde_end<br>body can be a string or null. detail is an object whose shape varies by event kind. |
| sabbats | Object Array | Yes | Sabbat events. Each item includes name, hemisphere, date_local, exact_utc, and kind. kind is one of:<br>- cross_quarter<br>- solar<br>hemisphere is one of north or south. |
| verified | String | Yes | Verification text returned by the service. |