Skip to content
96Astro API

Festivals & muhurta

Available

Regional Festivals by Calendar API

The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones.

  • POST /v1/festivals-muhurta/regional-festivals
  • 3 credits
Request
curl https://api.96astroapi.com/v1/festivals-muhurta/regional-festivals \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "calendar": "malayalam",
      "year": 2026
    }'

Overview

The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones.

Call it with POST /v1/festivals-muhurta/regional-festivals. Input: specific input. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/festivals-muhurta/regional-festivals
  • 3 credits
  • Specific input

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 dataInferred from the example response: a guide to the shape, not a contract.

  • calendarstring
  • yearnumber
  • placeobject
  • kindstring
  • month_start_ruleany
  • countnumber
  • festivalsarray of object
  • not_includedarray of object
  • rulestring
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 image data is shortened.

Loading the example…

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

FAQ

Regional Festivals by Calendar API: common questions

4answers

Ask the team
01What does the Regional Festivals by Calendar API return?

The main festivals of one regional calendar for a year, each by that calendar's own rule: Tamil, Malayalam, Bengali, Odia, Assamese, Telugu, Kannada, Marathi, Gujarati, Punjabi or Nepali, with the regional month and day for solar rules and the tithi, month and window for lunar ones. The response's data object includes calendar, year, place, kind, month_start_rule, count, festivals and not_included. See the reference for an example response.

02What input does Regional Festivals by Calendar need?

Specific input.

03How much does a Regional Festivals by 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.

Send us feedback

What is it about?