apyhub
STANDARD DATA

Get Sabbat Dates API

What it does

Sabbats Calendar returns the 8 Wheel-of-the-Year dates for the current year, for your chosen hemisphere. Send just hemisphere and get back this year's sabbats and solar events with both local dates and exact UTC timestamps.

Use Sabbats Calendar when you need seasonal dates for ritual planning, content scheduling, event calendars, or astrology and paganism applications. The response includes a count, the selected hemisphere, and a sabbats array. Each item includes name, hemisphere, date_local, exact_utc, and kind, where kind is either cross_quarter or solar.

It supports both north and south, so you can generate the correct seasonal calendar for either half of the world — no year range to configure, it always reflects the current year.

GET
Get Sabbat Dates
http://localhost:8080/creightonnick0/get-sabbats/v1/lunar/sabbats

QUICKSTART

GUIDE

Quickstart

Get this year's sabbats for a hemisphere — just one query parameter.

curl -X GET "http://localhost:8080/creightonnick0/get-sabbats/v1/lunar/sabbats?hemisphere=north" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

{
  "hemisphere": "north",
  "count": 8,
  "sabbats": [
    {
      "name": "Imbolc",
      "hemisphere": "north",
      "date_local": "2026-02-03",
      "exact_utc": "2026-02-03T20:02:07.770996+00:00",
      "kind": "cross_quarter"
    }
  ]
}
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.

About this endpoint

What it does

Returns this year's 8 Wheel-of-the-Year sabbats plus solstices/equinoxes for the selected hemisphere.

Query Parameter(s)

AttributeTypeMandatoryDescription
hemisphereStringYesAllowed values: north, south. Default: north.

Response

Returns a JSON object with hemisphere as a string, count as an integer, and sabbats as an array of objects. Each sabbat object contains name, hemisphere, date_local, exact_utc, and kind.

AttributeTypeMandatoryDescription
hemisphereStringYesAllowed values: north, south.
countIntegerYesTotal number of sabbat entries returned (8 for a full year).
sabbatsObject ArrayYesArray of sabbat objects.
sabbats[].nameStringYesSabbat name.
sabbats[].hemisphereStringYesAllowed values: north, south.
sabbats[].date_localStringYesLocal calendar date in date format.
sabbats[].exact_utcStringYesExact UTC timestamp in date-time format.
sabbats[].kindENUMYesAllowed values: cross_quarter, solar.

Query parameters

Name
Type
Description
hemisphereREQUIRED
string
north · south
DEFAULT north
▣ 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.