Date Specific Festivals

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

Returns all festivals details for given date in response

Headers

Name	Type	Description
Authorization*	String	your API Access Token eg: Bearer {token}

Request Body

Name	Type	Description
api_key*	String	your API key
year*	Integer	year, eg: 2025
month*	Integer	month, ex: 08
day*	Integer	day, ex: 09
place	String	place, ex: New Delhi
lat*	Float	latitude, eg: 28.6139
lon*	Float	longitude, eg: 77.2090
tzone*	Float	timezone, eg: 5.5 Timezone List

200: OK Fetched margashirsha festivals successfully!

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

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python :

cURL

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

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

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

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)