Date Specific Festivals API

The Date Specific Festivals API allows you to fetch all festivals occurring on a specific Gregorian date, providing their corresponding Panchang and cultural details, including festival names, images, and associated time periods.

Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/date-specific-festivals

Returns all festival details for the given date in the response.

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	Gregorian year, e.g. `2025`
month *	Integer	Gregorian month, e.g. `08`
day *	Integer	Gregorian day, e.g. `09`
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

Example Response — 200 OK

{
    "success": 1,
    "data": {
        "gayatri_jayanti": {
            "date": "2025-08-09",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Gayatri Jayanti.png"
        },
        "narali_purnima": {
            "date": "2025-08-09",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Narali Purnima.png"
        },
        "sanskrit_divas": {
            "date": "2025-08-09",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Sanskrit Divas.png"
        },
        "shraavana_maas": {
            "start_date": "2025-07-11",
            "end_date": "2025-08-09",
            "start_image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shraavana Maas Start.png",
            "end_image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shraavana Maas End.png"
        }
    }
}

Code Integration Examples

Below are sample implementations for calling the API in different programming environments.

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)