Festivals & muhurta
AvailableRegional Festivals by Calendar API
The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones.
- POST /v1/festivals-muhurta/regional-festivals
- 3 credits
curl https://api.96astroapi.com/v1/festivals-muhurta/regional-festivals \ -H "Authorization: Bearer $ASTRO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "calendar": "malayalam", "year": 2026 }'
Overview
The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones.
Call it with POST /v1/festivals-muhurta/regional-festivals. Input: specific input. Output: JSON, as a direct response. Each successful call costs 3 credits.
- POST /v1/festivals-muhurta/regional-festivals
- 3 credits
- Specific input
Try it
Response
Ready when you are
Press Run it to see the live response here.
Example response
Fields in dataInferred from the example response: a guide to the shape, not a contract.
calendarstringyearnumberplaceobjectkindstringmonth_start_ruleanycountnumberfestivalsarray of objectnot_includedarray of objectrulestring
200Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and image data is shortened.
Loading the example…
Request schema and every field: the Festivals & muhurta reference.
Related endpoints
- Regional CalendarsPanchang & almanac
- Bengali and Odia Equal MuhurtasPanchang & almanac
- Vrat CalendarFestivals & muhurta
- Festival CalendarFestivals & muhurta
- Religious CalendarsFestivals & muhurta
- Ekadashi CalendarFestivals & muhurta
- Wedding PlanFestivals & muhurta
- Vrat Observance CatalogueFestivals & muhurta
01What does the Regional Festivals by Calendar API return?
The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones. The response's data object includes calendar, year, place, kind, month_start_rule, count, festivals and not_included. See the reference for an example response.
02What input does Regional Festivals by Calendar need?
Specific input.
03How much does a Regional Festivals by Calendar call cost?
3 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
04Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.


