# Festival 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).

- Endpoint: `POST https://api.96astroapi.com/v1/festivals-muhurta/festival-group`
- Family: [Festivals & muhurta](https://96astroapi.com/apis/festivals-muhurta.md)
- Input: Date and place
- Cost: 3 credits per successful call (sandbox keys are free)
- Status: available
- Delivery: Direct response
- Output languages: en, hi, mr, bn, gu, ta, te, ml, kn, pa, ur, ne, or, as, si, fr, es, pt, de, it, nl, pl, tr, ru, ko, ja
- Web page: https://96astroapi.com/apis/festivals-muhurta/festival-group

## Example request

```bash
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}'
```

## Response

Every response is `{ "data": …, "meta": { "request_id", "credits_used", "warnings", "language" } }`.
The full request and response schema, with a captured example, is in the OpenAPI document: https://api.96astroapi.com/v1/openapi.json (path `/v1/festivals-muhurta/festival-group`).
