Find Phalguna Festivals
The Find Phalguna Festivals API is part of the DivineAPI’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
Supported Language Codes
Support Article URL: Translating Indian Vedic APIs into a Different Language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide:
These language codes are supported by this API. You can specify your preferred language by passing the parameter lan in the request body. Default language is en (English).
API 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 |
| include_name | String | YES/NO, default is NO. |
| lan | String | Default is en |
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.