96Astro API

Documentation

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 wantUse
Every festival and vrat of a year at a placefestival-calendar: search narrows it to one festival, upcoming gives the next 12 months
Every date of one recurring observancevrat-calendar and vrat-calendar-more (Rohini Vrat, Mangala Gauri, Sawan Somwar, Navagraha fasts, Ishti and more)
Ekadashi with Smarta and Vaishnava fasting daysekadashi-calendar
One tradition's yearreligious-calendar
A regional day or monthregional-calendar
The main festivals of one regional calendarregional-festivals
Navratri, Durga Puja, Mahadvadashi, ISKCONnavratri-calendar, durga-puja-calendar, mahadvadashi-calendar, iskcon-calendar
A Google Calendar or Apple Calendar filecalendar-ics, or "format": "ics" where offered: see calendar export
Everything for one day in one calltoday-feed
A reminder before an observanceObservance reminders

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 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 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 for what is and is not labelled.

The Today feed

today-feed 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.
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 }'
FieldMeaning
timePicks the choghadiya. Default: now at the place when date is today there, otherwise sunrise.
lookahead_days7 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. 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. The site also has free pages built on the same calculations: festival calendars, Ekadashi, Purnima and Sankranti, and the free tools.

Was this page helpful?

On this page

Send us feedback

What is it about?