By topic / Hindu Calendar API
Vedic
Hindu Calendar API: festivals, vrats, Ekadashi and samvat for any place
Festival dates depend on the place, because each one is judged at a particular time of the local day: sunrise for most, midnight for Janmashtami, the evening for Pradosha. Send a year and a location to get every festival and vrat by date, with the tithi and the moment each was judged at.
Ideas
What people build with it
A festival calendar on a temple or community site
Vrat and Ekadashi reminders in an app
A printed yearly panchang
Reference
The endpoints
- Festival CalendarEvery festival and vrat of a year at a place by date (Diwali, Holi, Janmashtami, Navratri, Ganesh Chaturthi, Ekadashi, Pradosha, Purnima, Amavasya and the rest), each judged in its own window by the daily panchang's rules; `search` narrows it to one festival and `upcoming` gives the next 12 months from today.POST/v1/festivals-muhurta/festival-calendar 3 credits
- Vrat CalendarEvery date in a year on which one recurring observance falls at a place, with its tithi, paksha, lunar month and the moment it was judged at.POST/v1/festivals-muhurta/vrat-calendar 3 credits
- Ekadashi CalendarEvery Ekadashi of a year at a place, by name (Kamada, Nirjala, Devshayani and the rest; Padmini and Parama in an adhika month), with the Smarta and Vaishnava fasting days and why they differ, the Ekadashi start and end, and the parana window (inside Dwadashi, after Hari Vasara, in pratahkal) for each. Also the year's eight kinds of Mahadvadashi (Unmilani, Vyanjuli, Trisprisha, Pakshavardhini, Jaya, Vijaya, Jayanti, Papanashini) and, on each Ekadashi, the Gauna (second) fasting day when the schools differ.POST/v1/festivals-muhurta/ekadashi-calendar 3 credits
- Religious CalendarsA year of observances for one tradition: hindu-solar (Makar Sankranti, Lohri, Pongal, Vaisakhi, Vishu, Pohela Boishakh, Onam), christian and orthodox (Easter by each computus, and the feasts from it), islamic (Hijri dates of Ramadan, the Eids, Muharram, Mawlid and more), sikh, jain or buddhist, each with its basis and convention; `search` narrows it to one observance and `upcoming` gives the next 12 months from today.POST/v1/festivals-muhurta/religious-calendar 3 credits
- Hindu Calendar DetailsShaka, Vikram and Kali samvat, amanta and purnimanta month, adhik/kshaya masa flags, ritu, ayana and day and night length.POST/v1/panchang/hindu-calendar 1 credit
- Festivals of the DayNames of the festivals falling on the day at the place.POST/v1/panchang/day-festivals 1 credit
- Eclipses, Equinoxes & SolsticesEvery solar and lunar eclipse of a year with type, global contacts and local visibility, magnitude and sutak, plus the equinoxes and solstices.POST/v1/panchang/eclipses 3 credits
- Regional CalendarsA day, or every day of the regional month, in one of ten Indian calendars: Malayalam, Bengali, Assamese (Bhaskarabda era), Odia (with its Amli administrative year beside the Shaka year), Nepali, Punjabi (solar) and Gujarati, Marathi, Telugu, Kannada (lunisolar).POST/v1/panchang/regional-calendar 3 credits
- Monthly PanchangPanchang for every day of a month at one place.POST/v1/panchang/monthly-panchang 3 credits
FAQ
Common questions
Why can a festival fall on different dates in two cities?
Sunrise and the tithi's end differ by place, so a festival judged at sunrise can land a day apart.
Amanta or purnimanta months?
Both are returned: hindu-calendar gives the month in each scheme, with adhik and kshaya masa flags.
Guides
Read next
Start building with the Hindu Calendar API
5,000 free trial credits. No card required.

