Festivals & muhurta
AvailableFestival Group Calendars (Diwali, Sankranti, Holi, Onam) API
A multi-day festival as numbered days at a place, each observance with the rule and window that decide its day and its puja windows: Diwali (Govatsa Dwadashi, Dhanteras and Yama Deepam, Kali Chaudas, Narak Chaturdashi, Lakshmi Puja, Diwali Snan, Govardhan Puja, Bhai Dooj), Makar Sankranti (Bhogi, Lohri, Sankranti, Mattu Pongal, Kanuma, Kaanum Pongal), Holi (Holashtak, Holika Dahan, Dhulandi) and Onam (Atham to Chathayam).
- POST /v1/festivals-muhurta/festival-group
- 3 credits
curl https://api.96astroapi.com/v1/festivals-muhurta/festival-group \ -H "Authorization: Bearer $ASTRO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "group": "diwali", "year": 2026, "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209 }'
Overview
A multi-day festival as numbered days at a place, each observance with the rule and window that decide its day and its puja windows: Diwali (Govatsa Dwadashi, Dhanteras and Yama Deepam, Kali Chaudas, Narak Chaturdashi, Lakshmi Puja, Diwali Snan, Govardhan Puja, Bhai Dooj), Makar Sankranti (Bhogi, Lohri, Sankranti, Mattu Pongal, Kanuma, Kaanum Pongal), Holi (Holashtak, Holika Dahan, Dhulandi) and Onam (Atham to Chathayam).
Call it with POST /v1/festivals-muhurta/festival-group. Input: date and place. Output: JSON, as a direct response. Each successful call costs 3 credits.
- POST /v1/festivals-muhurta/festival-group
- 3 credits
- Date and place
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.
countnumberdaysarray of objectrulestringunsupportedarray of objectsourcesarray of stringgroupstringyearnumberlatitudenumberlongitudenumbertimezonestring
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
FAQ
Festival Group Calendars (Diwali, Sankranti, Holi, Onam) API: common questions
4answers
Ask the team01What does the Festival Group Calendars (Diwali, Sankranti, Holi, Onam) API return?
A multi-day festival as numbered days at a place, each observance with the rule and window that decide its day and its puja windows: Diwali (Govatsa Dwadashi, Dhanteras and Yama Deepam, Kali Chaudas, Narak Chaturdashi, Lakshmi Puja, Diwali Snan, Govardhan Puja, Bhai Dooj), Makar Sankranti (Bhogi, Lohri, Sankranti, Mattu Pongal, Kanuma, Kaanum Pongal), Holi (Holashtak, Holika Dahan, Dhulandi) and Onam (Atham to Chathayam). The response's data object includes count, days, rule, unsupported, sources, group, year and latitude. See the reference for an example response.
02What input does Festival Group Calendars (Diwali, Sankranti, Holi, Onam) need?
Date and place.
03How much does a Festival Group Calendars (Diwali, Sankranti, Holi, Onam) 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.


