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 Divine 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

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': '861dc9bd7f4e7dd3cccd534d0ae2a2e9',
'year': '2023',
'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/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)