Hindu Calendar & Festival API
A Hindu festival and vrat calendar API: every festival, Ekadashi with parana, Pradosh, Sankashti, Purnima, Amavasya, Sankranti, Shraddha and eclipse for any city and year, verified against printed panchangs of 14 cities.
Why developers choose it
- Verified entry for entry against the printed panchang calendars of 14 cities on four continents: 4,427 of 4,427 entries on the same date.
- Classical observance rules: udaya, pradosh, nishita, moonrise, aparahna, kshaya and vriddhi tithis, adhik maas.
- Names in English, Hindi and regional languages; purnimanta or amanta months.
What you can build
Endpoints (11)
| Endpoint | What it returns | Credits |
|---|---|---|
| GET /v1/calendar/month | Complete Hindu calendar for a month — all tithis, nakshatras, yogas, special days. | 10 |
| GET /v1/calendar/adhik-maas | Adhik Maas (leap month) check and next occurrence. | 20 |
| GET /v1/calendar/samvatsara | Jovian year name (Samvatsara) for a given date. | 10 |
| GET /v1/calendar/ritu | Vedic season (Ritu) for a given date. | 10 |
| GET /v1/calendar/solstices | Equinoxes and solstices of a year — exact moment, Uttarayana/Dakshinayana, and sunrise/sunset/day length at your location. | 10 |
| GET /v1/eclipses/solar | Solar eclipses in a date range — type, peak, nakshatra; with lat/lon the local contact times, visibility and sutak kaal. | 20 |
| GET /v1/eclipses/lunar | Lunar eclipses in a date range — type, peak, nakshatra; with lat/lon the local contact times, visibility and sutak kaal. | 20 |
| GET /v1/eclipses/all | All solar and lunar eclipses in a date range (grahan list) — with lat/lon the local contact times, visibility and sutak kaal, as a printed panchang shows. | 20 |
| GET /v1/festivals/month | Full Hindu festival calendar for a month at a location: every named Ekadashi (smarta + Vaishnava/Gauna, with parana window), Pradosh by weekday, Sankashti/Vinayaka Chaturthi, every Purnima and Amavasya (Somavati, Darsha, Anvadhan, Ishti), Chandra Darshana, all 12 Sankrantis, major + regional festivals, lunar and fixed-date jayantis, national days, eclipses. verified entry for entry against the printed panchang calendars of 14 cities. | 20 |
| GET /v1/festivals/vrat | Year-wise Vrat & Upavas lists by type — every Ekadashi (smarta + Vaishnava, with parana), Pradosh, Sankashti, Vinayaka, Purnima, Amavasya, Chandra Darshana, Masik Shivaratri, Durgashtami, Kalashtami, Skanda Shashthi, Masik Karthigai, Shraddha (all 16 Pitru Paksha tithis), Janmashtami (Smarta/ISKCON), Sankranti, Satyanarayana Puja or eclipse of a year at a location. | 30 |
| GET /v1/festivals/on-date | All festivals, vrats and observances on one civil date at a location — same engine and fields as /v1/festivals/month. | 10 |
Learn more
Frequently asked questions
How accurate are the festival dates?
The engine reproduces every supported entry of the printed panchang calendars of 14 cities for a full year, 4,427 entries in total, and that check runs as an automated test on every change. See lifeastroapi.com/accuracy/.
Is there a free tier?
Yes. Every account gets 1,500 free credits a month with no card required. Paid plans start at ₹999 / $29 a month, and pay-as-you-go is available.
Can AI assistants such as Claude or Cursor call it directly?
Yes. The open-source LifeAstro MCP server exposes every endpoint as a tool for Claude Desktop, Cursor, Codex and other MCP clients that run local servers, using your existing API key.
Which ephemeris and ayanamsa does it use?
Planet positions come from the Swiss Ephemeris. Vedic calculations use the Lahiri (Chitrapaksha) ayanamsa by default; other ayanamsas can be selected per request.
Building an astrology app? 1,500 free API credits a month, no card
Try the Hindu Calendar & Festival API
Sign up for a free key and make your first call in a minute.
curl -H "Authorization: Bearer $LIFEASTRO_API_KEY" \
"https://api.lifeastroapi.com/v1/festivals/month?year=2027&month=10&lat=28.6139&lon=77.209&tz=Asia/Kolkata"