curl -X POST https://yogataraapi.prahlad.app/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.
| 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_festivalsWhich 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 |