Divine API
Copy page
Copy page as Markdown for LLMs
Find Phalguna Festivals
The Find Phalguna Festivals API is part of the Divine API’s Panchang suite. It provides detailed information about the Hindu month of Phalguna, including major festivals, auspicious timings (muhurats), and ritual details.
Step by Step Find Phalguna Festivals API Postman Testing Integration
Support Article URL - Testing Panchang API (Find Phalguna Festivals)
Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v2/phalguna-festivals
Returns all festival details from Phalguna month in 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 List |
200: OK - Fetched Phalguna Festivals Successfully
{
"success": 1,
"data": {
"year": "2023",
"vijaya_ekadashi": {
"smartas": {
"date": "2023-02-16",
"parana": {
"start_time": "2023-02-17 08:01:30",
"end_time": "2023-02-17 09:13:44"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vijaya%20Ekadashi.png"
},
"vaishnavas": {
"date": "2023-02-17",
"parana": {
"start_time": "2023-02-18 06:57:52",
"end_time": "2023-02-18 09:12:52"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vijaya%20Ekadashi.png"
}
},
"phulera_dooj": {
"date": "2023-02-21",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Phulera%20Dooj.png"
},
"amalaki_ekadashi": {
"smartas": {
"date": "2023-03-02",
"parana": {
"start_time": "2023-03-03 13:42:43",
"end_time": "2023-03-03 16:00:43"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Amalaki%20Ekadashi.png"
},
"vaishnavas": {
"date": "2023-03-03",
"parana": {
"start_time": "2023-03-04 06:44:09",
"end_time": "2023-03-04 09:05:09"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Amalaki%20Ekadashi.png"
}
},
"maha_shivratri": {
"date": "2023-02-18",
"nishita_muhurat": {
"start_time": "2023-02-19 00:10:29",
"end_time": "2023-02-19 01:01:29"
},
"prahar": {
"first_prahar": {
"start_time": "2023-02-18 18:13:29",
"end_time": "2023-02-18 21:24:29"
},
"second_prahar": {
"start_time": "2023-02-18 21:24:29",
"end_time": "2023-02-19 00:35:29"
},
"third_prahar": {
"start_time": "2023-02-19 00:35:29",
"end_time": "2023-02-19 03:46:29"
},
"fourth_prahar": {
"start_time": "2023-02-19 03:46:29",
"end_time": "2023-02-19 06:57:29"
}
},
"parana_time": {
"start_time": "2023-02-19 06:56:59",
"end_time": "2023-02-19 09:11:59"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Maha%20Shivratri.png"
},
"holika_dahan": {
"date": "2023-03-07",
"muhurat": {
"start_time": "2023-03-07 18:24:51",
"end_time": "2023-03-07 20:51:51"
},
"bhadra_kaal": {
"bhadra": {
"start_time": "2023-03-06 16:18:00",
"end_time": "2023-03-07 05:16:00"
},
"bhadra_punchha": {
"start_time": "2023-03-07 00:44:00",
"end_time": "2023-03-07 02:02:00"
},
"bhadra_mukha": {
"start_time": "2023-03-07 02:02:00",
"end_time": "2023-03-07 04:11:00"
}
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Holika%20Dahan.png"
},
"holi": {
"date": "2023-03-08",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Holi.png"
}
}
}Example Implementations
Below are examples of how to call this API using cURL, NodeJS, JavaScript (jQuery AJAX), and Python.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/phalguna-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/phalguna-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/phalguna-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/phalguna-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 your integration via Postman before deploying to production.
Always use HTTPS for secure communication.