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.
Supported Language Codes
Support Article URL: Translating Indian Vedic APIs into a Different Language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide:
These language codes are supported by this API. You can specify your preferred language by passing the parameter lan in the request body. Default language is en (English).
API 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 |
| include_name | String | YES/NO, default is NO. |
| lan | String | Default is en |
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': '{Your API Key}',
'year': '2025',
'place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}
files=[
]
headers = {
'Authorization': 'Bearer Bearer {Your Auth Token}'
}
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)