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

Support Article URL - Testing Panchang API (Find Magha Festivals)

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.