Festival Specific

Festival key name list:

varuthini_ekadashi

akshay_tritiya

parashuram_jayanti

ganga_saptami

sita_navami

mohini_ekadashi

narasimha_jayanti

buddha_purnima

kurma_jayanti

narada_jayanti

apara_ekadashi

vat_savitri_vrat

shani_amavasya

ganga_dussehra

nirjala_ekadashi

vat_purnima_vrat

mahesh_navami

yogini_ekadashi

jagannath_rathyatra

devshayani_ekadashi

guru_purnima

gauri_vrat

jaya_parvati_vrat

kokila_vrat

kamika_ekadashi

hariyaali_teej

naga_panchami

putrida_ekadashi

gayatri_jayanti

kalki_jayanti

hayagriva_jayanti

narali_purnima

sanskrit_divas

shraavana_maas

shraavana_somvaar_vrat

mangla_gauri_vrat

varalaxmi_vrat

gayatri_japam

kajari_teej

aja_ekadashi

hartalika_teej

ganesh_chaturthi

rishi_panchami

radha_ashtami

parsva_ekadashi

anant_chaturdashi

ganesh_visarjan

vamana_jayanti

mahalaxmi_vrat

durva_ashtami

pitru_paksha

indira_ekadashi

pitru_amavasya

papankusha_ekadashi

jivit_putrika_vrat

sharad_purnima

upang_lalita_vrat

kojagara_puja

karwa_chauth

ahoi_ashtami

rama_ekadashi

dhanteras

narak_chaturdashi

deepawali

goverdhan_puja

bhaiya_dooj

devutthani_ekadashi

chhath_puja

gopashtami

akshaya_navami

tulsi_vivah

kalabhairav_jayanti

utpanna_ekadashi

vivah_panchanmi

mokhada_ekadashi

gita_jayanti

dattatreya_jayanti

maa_annapurna_jayanti

saphala_ekadashi

pausha_putrida_ekadashi

banada_ashtami

shakambari_purnima

pausha_purnima

shattila_ekadashi

jaya_ekadashi

sakata_chauth

vasant_panchami

ratha_saptami

bheeshma_ashtami

mauni_amavasya

vijaya_ekadashi

phulera_dooj

amalaki_ekadashi

maha_shivratri

sheetla_ashtami

papamochani_ekadashi

rang_panchami

ugadi

gudi_padwa

gangaur

yamuna_chhath

ram_navami

kamada_ekadashi

hanuman_jayanti

chaitra_purnima

POST https://astroapi-3.divineapi.com/indian-api/v1/find-festival

Returns all details for given festival in response

Headers

Name	Type	Description
Authorization*	String	your API Access Token eg: Bearer {token}

Request Body

Name	Type	Description
api_key*	String	your API key
year*	Integer	year, eg: 2025
place	String	place, ex: New Delhi
lat*	Float	latitude, eg: 28.6139
lon*	Float	longitude, eg: 77.2090
tzone*	Float	timezone, eg: 5.5 Timezone List
festival*	String	festival key name, ex: shraavana_somvaar_vrat

200: OK Fetched margashirsha festivals successfully!

{
    "success": 1,
    "data": {
        "dates": {
            "1": "2025-07-14",
            "2": "2025-07-21",
            "3": "2025-07-28",
            "4": "2025-08-04"
        },
        "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shraavana Somvaar.png"
    }
}

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python :

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/date-specific-festivals' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'year="2025"' \
--form 'Place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/date-specific-festivals',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'year': '2025',
    'Place': 'New Delhi',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("year", "2025");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/date-specific-festivals",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/margashirsh-festivals"

payload = {'api_key': '861dc9bd7f4e7dd3cccd534d0ae2a2e9',
'year': '2025',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}
files=[

]
headers = {
  'Authorization': 'Bearer Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL2FzdHJvYXBpLTEuZGl2aW5lYXBpLmNvbS9hcGkvYXV0aC1hcGktcmVmcmVzaC10b2tlbiIsImlhdCI6MTY5OTI1NDAzOSwibmJmIjoxNjk5MjU0MjYxLCJqdGkiOiJBTG1OQ3BweW5aUHg2dnZGIiwic3ViIjoiMTM1MCJ9.TQM3mTq7FRt21uKMtXyPT5polqUsbzW5YRMwTHb587Q'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Python

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/date-specific-festivals"

payload = {'api_key': '{Your API Key}',
'year': '2025',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)