Find Margashirsha Festivals API

Discover auspicious events and cultural observances during the sacred month of Margashirsha with the Find Margashirsha Festivals API. This API returns details of all major festivals that occur in the Margashirsha month according to the Hindu Panchang, including event dates, parana timings, and associated festival images.

Step-by-Step Find Margashirsha Festivals API Postman Testing Integration

Refer to the official guide for instructions on how to test this API using Postman:
Find Margashirsha Festivals API Postman Testing Integration

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v2/margashirsh-festivals

This endpoint provides festival data for the Margashirsha month, including dates, images, and parana timings (if applicable).

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

Name	Type	Required	Description
api_key	String	Yes	Your Divine API key.
year	Integer	Yes	The year for which you want to fetch Margashirsha festival data. Example: `2023`.
place	String	No	The name of the place. Example: `New Delhi`.
lat	Float	Yes	Latitude of the location. Example: `28.6139`.
lon	Float	Yes	Longitude of the location. Example: `77.2090`.
tzone	Float	Yes	Timezone offset for the location. Example: `5.5`. See: Timezone Guide

200: OK Fetched Maghashirsha festivals successfully

{
    "success": 1,
    "data": {
        "year": "2023",
        "kalabhairav_jayanti": {
            "date": "2023-12-05",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kaal%20Bhairava%20Jayanti.png"
        },
        "utpanna_ekadashi": {
            "smartas": {
                "date": "2023-12-08",
                "parana": {
                    "start_time": "2023-12-09 13:15:32",
                    "end_time": "2023-12-09 15:18:32"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Utpanna%20Ekadashi.png"
            },
            "vaishnavas": {
                "date": "2023-12-08",
                "parana": {
                    "start_time": "2023-12-09 13:15:32",
                    "end_time": "2023-12-09 15:18:32"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Utpanna%20Ekadashi.png"
            }
        },
        "vivah_panchanmi": {
            "date": "2023-12-17",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vivah%20Panchanmi.png"
        },
        "mokhada_ekadashi": {
            "smartas": {
                "date": "2023-12-22",
                "parana": {
                    "start_time": "2023-12-23 13:22:29",
                    "end_time": "2023-12-23 15:25:29"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mokhada%20Ekadashi.png"
            },
            "vaishnavas": {
                "date": "2023-12-23",
                "parana": {
                    "start_time": "2023-12-24 07:11:27",
                    "end_time": "2023-12-24 09:14:27"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mokhada%20Ekadashi.png"
            }
        },
        "gita_jayanti": {
            "date": "2023-12-22",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Gita%20Jayanti.png"
        },
        "dattatreya_jayanti": {
            "date": "2023-12-26",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Dattatreya%20Jayanti.png"
        },
        "maa_annapurna_jayanti": {
            "date": "2023-12-26",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Maa%20Annapurna%20Jayanti.png"
        }
    }
}

Response Explanation

success
Indicates if the request was successful. Value 1 represents success.

data
Contains all major Margashirsha festivals and their details.

Festival Name: Each key corresponds to a festival name (e.g., kalabhairav_jayanti, gita_jayanti).

date: The Gregorian date of the festival.

parana: For Ekadashis, includes start and end times of the breaking period (parana).

image: URL of the corresponding festival image (useful for UI display).

smartas / vaishnavas: Some festivals have variations based on sects. Each includes its respective date, parana, and image.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/margashirsh-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

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/margashirsh-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

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/v2/margashirsh-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

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v2/margashirsh-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)

Implementation Notes

Always include both api_key and Authorization headers.

Margashirsha is the ninth lunar month in the Hindu calendar, typically falling between November and December.

The API includes both Smarta and Vaishnava versions of Ekadashi observances where applicable.

Use the provided image URLs to visually represent festivals in your application interface.

Recommended for Panchang-based apps, event calendars, and festival scheduling dashboards.