Find Magha Festivals
Celebrate the essence of Magha Month with our Magha Festivals API, designed to deliver comprehensive details about the festivals, observances, and rituals that occur during the Magha lunar month as per the Indian Panchang (Vedic Calendar).
This API provides festival names, tithis, muhurat timings, parana windows, and corresponding images for both Smarta and Vaishnava traditions.
Step by Step Find Magha Festivals API Postman Testing Integration
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v2/magha-festivals
Returns Magha Month Festival Details in JSON 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 | year, e.g., 2023 |
| 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 — Timezone Reference Guide |
200: OK - Fetched Magha Festivals Successfully
{
"success": 1,
"data": {
"year": "2023",
"shattila_ekadashi": {
"smartas": {
"date": "2023-01-18",
"parana": {
"start_time": "2023-01-19 07:15:00",
"end_time": "2023-01-19 09:21:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shattila%20Ekadashi.png"
},
"vaishnavas": {
"date": "2023-01-18",
"parana": {
"start_time": "2023-01-19 07:15:00",
"end_time": "2023-01-19 09:21:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shattila%20Ekadashi.png"
}
},
"jaya_ekadashi": {
"smartas": {
"date": "2023-02-01",
"parana": {
"start_time": "2023-02-02 07:09:33",
"end_time": "2023-02-02 09:18:33"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vijaya%20Ekadashi.png"
},
"vaishnavas": {
"date": "2023-02-01",
"parana": {
"start_time": "2023-02-02 07:09:33",
"end_time": "2023-02-02 09:18:33"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vijaya%20Ekadashi.png"
}
},
"sakata_chauth": {
"date": "2023-01-10",
"moonrise": "2023-01-10 20:41:45",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vijaya%20Ekadashi.png"
},
"vasant_panchami": {
"date": "2023-01-26",
"muhurat": {
"start_time": "2023-01-26 07:12:54",
"end_time": "2023-01-26 12:33:54"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vasant%20Panchami.png"
},
"ratha_saptami": {
"date": "2023-01-28",
"muhurat": {
"start_time": "2023-01-28 05:26:04",
"end_time": "2023-01-28 07:12:04"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ratha%20Saptami.png"
},
"bheeshma_ashtami": {
"date": "2023-01-28",
"madhyahna_time": {
"start_time": "2023-01-28 11:28:34",
"end_time": "2023-01-28 13:40:34"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Bheeshma%20Ashtami.png"
},
"mauni_amavasya": {
"date": "2023-01-21",
"muhurat": {
"start_time": "2023-01-21 05:26:32",
"end_time": "2023-01-21 07:14:32"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mauni%20Amavasya.png"
}
}
}
Example Implementations
Below are examples of how to integrate and test this API using cURL, NodeJS, JavaScript (jQuery AJAX), and Python.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/magha-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/magha-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/magha-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);
});Python
import requests
url = "https://astroapi-3.divineapi.com/indian-api/v2/magha-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
Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.
Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).
Always check HTTP status codes, log responses, and handle 4xx and 5xx errors gracefully.
Defaults for lan are not applicable for this endpoint unless specified.
Test via Postman before production use, and always use HTTPS for secure communication.