Festival Specific API

The Festival Specific API allows you to fetch complete details for a specific Hindu festival by passing its key name, year, and location parameters. This is especially useful for displaying data related to a particular festival such as date(s), timings, and images on websites, dashboards, or applications.

Endpoint

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

Returns all festival details for the given festival key name in the response.

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

Headers

Name	Type	Description
Authorization *	String	Your API Access Token e.g. `Bearer {token}`

Request Body

Name	Type	Description
api_key *	String	Your API key
year *	Integer	Year, e.g. `2025`
place	String	Place, e.g. `New Delhi`
lat *	Float	Latitude, e.g. `28.6139`
lon *	Float	Longitude, e.g. `77.2090`
tzone *	Float	Timezone, e.g. `5.5` — see: Timezone List
festival *	String	Festival key name, e.g. `shraavana_somvaar_vrat`

Example Response — 200 OK Successful

{
    "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"
    }
}

Code Integration Examples

Below are example implementations for calling the API using various programming languages and tools.

cURL Example

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 Example

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) Example

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 Example

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)

Use Case

This endpoint is particularly useful when you need:

Details for a specific Hindu festival (e.g., Ekadashi, Purnima, Vrat days, etc.)

To display multiple occurrence dates (if the festival recurs)

To fetch festival images and related visuals dynamically for UI or mobile apps