Find Choghadiya API
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.
Step-by-Step Find Choghadiya API Postman Testing Integration
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
Supported Language Codes
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.
API Endpoint
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.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token, e.g. Bearer {token} |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | String | Yes | Your 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. |
200: OK Choghadiyas fetched successfully
{
"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"
}
}
}Response Structure
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.
Choghadiya Types (General Reference)
Amrit / Shubh / Labh / Char: Generally considered favorable.
Udveg / Kaal / Rog: Generally considered unfavorable.
The API orders them chronologically for the given date and location.
Example Code Implementations
Below are example implementations in various programming environments.
cURL
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"'
NodeJS
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);
});
JavaScript jQuery AJAX
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);
});Python
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)
Implementation Notes
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.