POSThttps://api.occultapi.com/api/festivals/

Festival calendar (precomputed)

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://api.occultapi.com/api/festivals/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":9,"keys":["festivals","ekadashis"]}'

Precomputed festival dates across four traditions, read straight from a table rather than calculated on the request, so a whole year comes back in one indexed query. `keys` chooses which lists you want: `festivals` is the main Hindu calendar, `ekadashis` the twenty-four or twenty-six named Ekadashis of the year, and `jain_festivals`, `sikh_festivals` and `christian_festivals` the corresponding calendars. `year` is required and `month` (1-12) is optional; omit the month to get the whole year. The response is `{data}` keyed by each requested category, each holding a chronological list of events. An event carries `name`, `name_hi` (a Hindi rendering, currently populated only for the main Hindu category and null elsewhere), `month` (the lunar month name), `paksha`, `tithi` (used by the Sikh list), `date` (used where the observance is on a fixed civil date, as the Christian festivals are) and `start_time`/`end_time`, which are the exact instants the governing tithi begins and ends. Dates are precomputed for the years 2006 to 2046 inclusive. Anything outside that range returns empty lists rather than an error. Because the underlying rows are stored rather than derived per request, this endpoint takes no coordinates; if you need a location-sensitive observance day, use the regional calendar endpoints, which resolve each festival to a civil day using local sunrise and sunset.

Request fields

Field Type Required Notes

keys

array

Field	Type	Required	Notes
keys	array	required	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls. `festivalsekadashisjain_festivalssikh_festivalschristian_festivals` Which festival calendars to return. 'festivals' is the main Hindu calendar; the others are separate traditions. Ask for several in one call - the response is keyed by category and the cost is the same.
year	integer	required	Year of birth as a number, e.g. 1990. Four digits. Four-digit year. Dates are precomputed for 2006 to 2046; outside that range the response is empty.
month	integer	optional	Month of birth as a number, 1-12. January is 1. Optional 1-12. Omit it to get the whole year. min 1 · max 12

required

Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.

festivalsekadashisjain_festivalssikh_festivalschristian_festivals

Which festival calendars to return. 'festivals' is the main Hindu calendar; the others are separate traditions. Ask for several in one call - the response is keyed by category and the cost is the same.

year

integer

required

Year of birth as a number, e.g. 1990. Four digits.

Four-digit year. Dates are precomputed for 2006 to 2046; outside that range the response is empty.

month

integer

optional

Month of birth as a number, 1-12. January is 1.

Optional 1-12. Omit it to get the whole year.

min 1 · max 12

Full reference for this endpoint

POSThttps://api.occultapi.com/api/festivals/

Festival calendar (precomputed)

Reference

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://api.occultapi.com/api/festivals/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":9,"keys":["festivals","ekadashis"]}'

Request fields

Field Type Required Notes

keys

array

Field	Type	Required	Notes
keys	array	required	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls. `festivalsekadashisjain_festivalssikh_festivalschristian_festivals` Which festival calendars to return. 'festivals' is the main Hindu calendar; the others are separate traditions. Ask for several in one call - the response is keyed by category and the cost is the same.
year	integer	required	Year of birth as a number, e.g. 1990. Four digits. Four-digit year. Dates are precomputed for 2006 to 2046; outside that range the response is empty.
month	integer	optional	Month of birth as a number, 1-12. January is 1. Optional 1-12. Omit it to get the whole year. min 1 · max 12

required

festivalsekadashisjain_festivalssikh_festivalschristian_festivals

year

integer

required

Year of birth as a number, e.g. 1990. Four digits.

Four-digit year. Dates are precomputed for 2006 to 2046; outside that range the response is empty.

month

integer

optional

Month of birth as a number, 1-12. January is 1.

Optional 1-12. Omit it to get the whole year.

min 1 · max 12

Full reference for this endpoint