# Festivals and regional calendars

Festival, vrat and regional calendar capabilities, how each festival is judged in its own window, regional festival rules, Sankranti attributes and the Today feed.

Festivals are not all decided at sunrise. The API judges each one in its own window (sunrise, Aparahna, Pradosh or Nishita) with the same rules as the daily panchang, so a date from a calendar capability always agrees with `daily-panchang` for that day. Years 1900 to 2200; latitude within 66 degrees of the equator.

## Which capability to use

| You want | Use |
|---|---|
| Every festival and vrat of a year at a place | [`festival-calendar`](https://96astroapi.com/apis/festivals-muhurta/festival-calendar.md): `search` narrows it to one festival, `upcoming` gives the next 12 months |
| Every date of one recurring observance | [`vrat-calendar`](https://96astroapi.com/apis/festivals-muhurta/vrat-calendar.md) and [`vrat-calendar-more`](https://96astroapi.com/apis/festivals-muhurta/vrat-calendar-more.md) (Rohini Vrat, Mangala Gauri, Sawan Somwar, Navagraha fasts, Ishti and more) |
| Ekadashi with Smarta and Vaishnava fasting days | [`ekadashi-calendar`](https://96astroapi.com/apis/festivals-muhurta/ekadashi-calendar.md) |
| One tradition's year | [`religious-calendar`](https://96astroapi.com/apis/festivals-muhurta/religious-calendar.md) |
| A regional day or month | [`regional-calendar`](https://96astroapi.com/apis/panchang/regional-calendar.md) |
| The main festivals of one regional calendar | [`regional-festivals`](https://96astroapi.com/apis/festivals-muhurta/regional-festivals.md) |
| Navratri, Durga Puja, Mahadvadashi, ISKCON | [`navratri-calendar`](https://96astroapi.com/apis/festivals-muhurta/navratri-calendar.md), [`durga-puja-calendar`](https://96astroapi.com/apis/festivals-muhurta/durga-puja-calendar.md), [`mahadvadashi-calendar`](https://96astroapi.com/apis/festivals-muhurta/mahadvadashi-calendar.md), [`iskcon-calendar`](https://96astroapi.com/apis/festivals-muhurta/iskcon-calendar.md) |
| A Google Calendar or Apple Calendar file | [`calendar-ics`](https://96astroapi.com/apis/festivals-muhurta/calendar-ics.md), or `"format": "ics"` where offered: see [calendar export](https://96astroapi.com/docs/requests-and-responses.md#calendar-export-ics) |
| Everything for one day in one call | [`today-feed`](#the-today-feed) |
| A reminder before an observance | [Observance reminders](https://96astroapi.com/docs/observance-subscriptions.md) |

Regional traditions differ on some observances. When they do, the answer states which rule it used.

## Regional festivals

`regional-festivals` takes one calendar (Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali) and a year.

- **Solar festivals** are days of the calendar's own months (for example Puthandu is Chithirai 1, Vishu is Medam 1, Pohela Boishakh is Boishakh 1). The first day of a month follows that calendar's rule exactly as `regional-calendar` does: Tamil, Sankranti before sunset; Kerala, before the end of the third fifth of daylight; Bengal, midnight; Odisha, Hindu midnight; Nepal, Punjab and Assam, the civil date of the Sankranti.
- **Lunar festivals** are tithis of the amanta month in a named window, judged like `festival-calendar`.
- Each row has a `name_source`: `drikpanchang` for a name DrikPanchang's regional pages list, or `tradition` for a name whose rule is stated but not independently cited.
- Rules the API cannot state are returned under `not_included` (for example nakshatra-in-month festivals such as Karthigai Deepam and Thai Poosam). Nepal's own tithi arithmetic differs from this engine's, so its lunar rows use the standard method. The Assamese month start rule is unverified.

## Sankranti attributes

[`sankranti-detail`](https://96astroapi.com/apis/festivals-muhurta/sankranti-detail.md) returns the year's twelve Sankrantis with the moment, weekday and traditional name, the day it is kept, Punya Kaal and Maha Punya Kaal, karana, tithi and the Moon's nakshatra. Each also carries the **vahana and attributes** the Muhurta Chintamani verses give (vastra, ayudha, bhakshya, lepana, pushpa and posture), chosen by the karana at the ingress: Bava lion, Balava tiger, Kaulava boar, Taitila donkey, Gara elephant, Vanija buffalo, Vishti horse, Shakuni dog, Chatushpada goat, Naga bull, Kimstughna rooster.

- Punya Kaal follows the Sankranti type (Nirnayasindhu and Dharmasindhu). Maha Punya Kaal is our convention: the four ghatis nearest the moment.
- One transcription reads the Naga karana as Cow. [`sankranti-vahana-profile`](https://96astroapi.com/apis/festivals-muhurta/sankranti-vahana-profile.md) lets you pick a source profile (`muhurta_chintamani_livepanditji`, the default, or `muhurta_chintamani_vedicpupil`) and records the conflict.
- Upavahana, direction and age are listed as unsupported: they are not in the verses used.

## Bengali and Odia day muhurtas

`regional-muhurtas` gives fifteen day and fifteen night muhurtas for the Bengali or Odia tradition as computed windows. See [Panchang traditions, profiles and status](https://96astroapi.com/docs/panchang-traditions-and-profiles.md#bengali-and-odia-day-muhurtas) for what is and is not labelled.

## The Today feed

[`today-feed`](https://96astroapi.com/apis/panchang/today-feed.md) is one call for a date and place that returns what a "today" screen needs:

- the panchang (five limbs with end times, sunrise and sunset, Rahu Kaal, Abhijit, the choghadiya in force and the next one);
- the day's festivals and vrats, and the Sankranti, eclipse and planetary events of the day;
- the next Ekadashi, Purnima, Amavasya, Pradosh and Sankashti Chaturthi, and the next few festivals.

```bash
curl https://api.96astroapi.com/v1/panchang/today-feed -H "Authorization: Bearer $ASTRO_API_KEY" -H "Content-Type: application/json" -d '{ "date": "2026-11-21", "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209 }'
```

| Field | Meaning |
|---|---|
| `time` | Picks the choghadiya. Default: now at the place when `date` is today there, otherwise sunrise. |
| `lookahead_days` | 7 to 120, default 45: how far ahead the next observances, festivals, eclipse and Sankranti are looked for. `next_eclipse` and `next_sankranti` are `null` when none falls inside it. |

Each section is the answer of the capability it comes from (`daily-panchang`, `festival-calendar`, `ekadashi-calendar`, the vrat calendars, `sankranti-detail`, `eclipses`, `planetary-events`), cut to what a day screen needs, so the numbers agree with them. It is a bundle priced at 5 standard calls, about a fifth of the cost of calling those capabilities separately; the price follows the [price book](https://96astroapi.com/pricing/endpoints). A section that cannot be calculated is left out and named in `meta.warnings`; if the panchang itself fails, the call fails and is not charged.

To be told instead of asking, use [observance reminders](https://96astroapi.com/docs/observance-subscriptions.md). The site also has free pages built on the same calculations: [festival calendars](https://96astroapi.com/festivals), [Ekadashi](https://96astroapi.com/ekadashi), [Purnima](https://96astroapi.com/purnima) and [Sankranti](https://96astroapi.com/sankranti), and the free [tools](https://96astroapi.com/tools).
