Skip to content
96Astro API
Get API Key

Festivals & muhurta

Available

Festival Calendar API

Every 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
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/festivals-muhurta/festival-calendar \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "year": 2026,
      "timezone": "Asia/Kolkata",
      "latitude": 28.6139,
      "longitude": 77.209
    }'

Overview

Every 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.

Call it with POST /v1/festivals-muhurta/festival-calendar. Input: date and place. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/festivals-muhurta/festival-calendar
  • 3 credits
  • Date and place

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataMeasured from 3 real answers to different inputs: a required field was in every one.

  • yearnumber
  • latitudenumber
  • longitudenumber
  • timezonestring
  • searchany
  • countnumber
  • daysarray of object
  • conventionstring
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.

Loading the example…

Request schema and every field: the Festivals & muhurta reference.

Related endpoints

FAQ

Festival Calendar API: common questions

4answers

Ask the team
01What does the Festival Calendar API return?

Every 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. The response's data object includes year, latitude, longitude, timezone, search, count, days and convention. See the reference for an example response.

02What input does Festival Calendar need?

Date and place.

03How much does a Festival Calendar call cost?

3 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.