English Calendar Specific Festivals API
The English Calendar Specific Festivals API allows you to fetch all festival details for a given Gregorian (English) month and year, mapped to the Panchang-based festival data returned by DivineAPI.
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/english-calendar-festivals
Returns all festival details for the specified month 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. 2023 |
| month * | Integer | Gregorian month, e.g. 12 for December |
| 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": {
"kalabhairav_jayanti": {
"date": "2023-12-05",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kaal Bhairava Jayanti.png"
},
"utpanna_ekadashi": {
"smartas": {
"date": "2023-12-08",
"parana": {
"start_time": "2023-12-09 13:07:29",
"end_time": "2023-12-09 15:13:29"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Utpanna Ekadashi.png"
},
"vaishnavas": {
"date": "2023-12-09",
"parana": {
"start_time": "2023-12-10 06:53:11",
"end_time": "2023-12-10 07:13:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Utpanna Ekadashi.png"
}
},
"vivah_panchanmi": {
"date": "2023-12-17",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vivah Panchanmi.png"
},
"mokhada_ekadashi": {
"smartas": {
"date": "2023-12-22",
"parana": {
"start_time": "2023-12-23 13:12:55",
"end_time": "2023-12-23 15:15:55"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mokhada Ekadashi.png"
},
"vaishnavas": {
"date": "2023-12-23",
"parana": {
"start_time": "2023-12-24 07:01:23",
"end_time": "2023-12-24 09:04:23"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mokhada Ekadashi.png"
}
},
"gita_jayanti": {
"date": "2023-12-22",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Gita Jayanti.png"
},
"dattatreya_jayanti": {
"date": "2023-12-26",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Dattatreya Jayanti.png"
},
"maa_annapurna_jayanti": {
"date": "2023-12-26",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Maa Annapurna Jayanti.png"
}
}
}Code Integration Examples
Below are sample implementations showing how to call this API in different environments.
cURL Example
curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/english-calendar-festivals' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'year="2023"' \
--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/english-calendar-festivals',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'year': '2023',
'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", "2023");
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/english-calendar-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': '2023',
'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/english-calendar-festivals"
payload = {'api_key': '{Your API Key}',
'year': '2023',
'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)