Copy page
Copy page as Markdown for LLMs
Optimize daily actions by identifying auspicious (Shubh, Amrit, Labh, Char) and inauspicious (Kaal, Rog, Udveg) time blocks with the Find Choghadiya API. This API calculates day and night choghadiyas for a given date and location, following traditional Indian Astrology principles.\
Detailed testing instructions are available here:
Step by Step Find Choghadiya API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-choghadiya-api-using-postman
You can localize the API response by passing the lan field in the body.
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Note: If lan is not provided, the API defaults to en.
POST https://astroapi-2.divineapi.com/indian-api/v1/find-choghadiya
This endpoint returns day and night choghadiya slots for the given date and place.
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token, e.g. Bearer {token} |
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | String | Yes | Your Divine API key. |
| day | Integer | Yes | Panchang day, e.g. 24. |
| month | Integer | Yes | Panchang month, e.g. 05. |
| year | Integer | Yes | Panchang year, e.g. 2023. |
| place | String | No | Place name, e.g. New Delhi. |
| lat | Float | Yes | Latitude, e.g. 28.6139. |
| lon | Float | Yes | Longitude, e.g. 77.2090. |
| tzone | Float | Yes | Timezone offset, e.g. 5.5. See timezone guide in Divine docs. |
| lan | String | No | Response language code. Default en. |
{
"success": 1,
"data": {
"day_choghadiyas": {
"Labh": "05:26 AM to 07:09 AM",
"Amrit": "07:09 AM to 08:52 AM",
"Kaal": "08:52 AM to 10:35 AM",
"Shubh": "10:35 AM to 12:18 PM",
"Rog": "12:18 PM to 02:01 PM",
"Udveg": "02:01 PM to 03:44 PM",
"Char": "03:44 PM to 05:27 PM",
"Next Labh": "05:27 PM to 07:10 PM"
},
"night_choghadiyas": {
"Udveg": "07:10 PM to 08:27 PM",
"Shubh": "08:27 PM to 09:44 PM",
"Amrit": "09:44 PM to 11:01 PM",
"Char": "11:01 PM to 12:18 AM May 25",
"Rog": "12:18 AM to 01:35 AM May 25",
"Kaal": "01:35 AM to 02:52 AM May 25",
"Labh": "02:52 AM to 04:09 AM May 25",
"Next Udveg": "04:09 AM to 05:26 AM May 25"
}
}
}success
Indicates whether the API call was successful. 1 means success.
data.day_choghadiyas
A map of choghadiya names to their corresponding time intervals for daytime (sunrise to sunset).
data.night_choghadiyas
A map of choghadiya names to their corresponding time intervals for nighttime (sunset to next sunrise).
Time values are already formatted and user-friendly, so they can be displayed directly in an app or panel.
Amrit / Shubh / Labh / Char: Generally considered favorable.
Udveg / Kaal / Rog: Generally considered unfavorable.
The API orders them chronologically for the given date and location.
Below are example implementations in various programming environments.
curl --location 'https://astroapi-2.divineapi.com/indian-api/v1/find-choghadiya' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"' \
--form 'lan="en"'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-2.divineapi.com/indian-api/v1/find-choghadiya',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-2.divineapi.com/indian-api/v1/find-choghadiya",
"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-2.divineapi.com/indian-api/v1/find-choghadiya"
payload = {'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Always send accurate latitude, longitude, and timezone to get correct sunrise/sunset-based choghadiya.
You can display day and night choghadiya separately in your UI.
For multi-language apps, pass lan so the API gives translated labels where supported.
This API fits well with daily panchang dashboards, muhurta pickers, and astrology scheduling tools.