# Regional 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.

- Endpoint: `POST https://api.96astroapi.com/v1/festivals-muhurta/regional-festivals`
- Family: [Festivals & muhurta](https://96astroapi.com/apis/festivals-muhurta.md)
- Input: Specific input
- 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/regional-festivals

## Example request

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

## 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/regional-festivals`).
