Divine API
Copy page
Copy page as Markdown for LLMs
Find Panchang API
The Find Panchang API provides daily Panchang details such as Nakshatra, Tithi, Yoga, Karana, sunrise, sunset, and related Vedic calendar data for a given date, time zone, and location. This is ideal for astrology platforms, Hindu calendar apps, muhurta tools, and daily Panchang widgets.
Authentication Note
API Key and API Access Token are mandatory.
You can obtain both from your Divine account under the Profile Details page.
Postman Testing Guide
For a step-by-step walkthrough on how to test this API using Postman, refer to the official documentation:
Step by Step Find Panchang API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-panchang-api-using-postman
Supported Language Codes
This API supports multiple Indian languages. You can pass the lan field in the request body to get the response in the desired language. If not provided, the default is en.
Reference article:
https://support.divineapi.com/general-api-support/translating-an-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 languages are supported by this API. Use the lan parameter in the request body to switch the language.
Endpoint
POST https://astroapi-1.divineapi.com/indian-api/v2/find-panchang
This endpoint returns Panchang details for the supplied date and location.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Your API Access Token. Example: Bearer {token} |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | String | Yes | Your API key. |
| day | Integer | Yes | Day of Panchang. Example: 24. |
| month | Integer | Yes | Month of Panchang. Example: 05. |
| year | Integer | Yes | Year of Panchang. Example: 2023. |
| place | String | No | Place name. Example: New Delhi. |
| lat | Float | Yes | Latitude of the place. Example: 28.6139. |
| lon | Float | Yes | Longitude of the place. Example: 77.2090. |
| tzone | Float | Yes | Timezone offset. Example: 5.5. See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide |
| lan | String | No | Response language code. Default is en. |
Note: In some sample code, the field is shown as Place. To maintain consistency, prefer place (lowercase) in your implementation, based on your API spec.
200: OK Panchang details fetched successfully
{
"success": 1,
"data": {
"sunrise": "2025-07-23 05:58:11",
"sunset": "2025-07-23 20:46:48",
"nakshatras": {
"zodiac_point": [
{
"sign": "Gemini",
"end_time": "2025-07-24 01:29:11"
},
{
"sign": "Cancer",
"end_time": ""
}
],
"nakshatra_list": [
{
"nak_name": "Aradra",
"end_time": "2025-07-23 08:24:11"
},
{
"nak_name": "Punarvasu",
"end_time": ""
}
],
"nakshatra_pada": [
{
"nak_name": "Aradra",
"lord": "Rahu",
"deity": "Rudra",
"element": "Jala",
"symbol": "Tear Drop",
"syllables": "कु, घ, ङ, छ",
"pursuit": "Kama",
"gana": "Manushya",
"direction": "West",
"guna": "Tamasik",
"body_part": "Hair , Eyes , Back & front side of head",
"color": "Red",
"nak_number": 6,
"nak_pada": 4,
"end_time": "2025-07-23 08:24:11",
"end_time_seprated": {
"day": "23",
"month": "07",
"year": "2025",
"hour": "08",
"minute": "24",
"second": "11"
}
},
{
"nak_name": "Punarvasu",
"lord": "Jupiter",
"deity": "Aditi",
"element": "Jala",
"symbol": "Bow and Quiver",
"syllables": "के, को, हा, ही",
"pursuit": "Artha",
"gana": "Dev",
"direction": "North",
"guna": "Sattavik",
"body_part": "Finger & Nose",
"color": "Green/Silver",
"nak_number": 7,
"nak_pada": 1,
"end_time": "2025-07-23 14:04:11",
"end_time_seprated": {
"day": "23",
"month": "07",
"year": "2025",
"hour": "14",
"minute": "04",
"second": "11"
}
},
{
"nak_name": "Punarvasu",
"lord": "Jupiter",
"deity": "Aditi",
"element": "Jala",
"symbol": "Bow and Quiver",
"syllables": "के, को, हा, ही",
"pursuit": "Artha",
"gana": "Dev",
"direction": "North",
"guna": "Sattavik",
"body_part": "Finger & Nose",
"color": "Green/Silver",
"nak_number": 7,
"nak_pada": 2,
"end_time": "2025-07-23 19:46:11",
"end_time_seprated": {
"day": "23",
"month": "07",
"year": "2025",
"hour": "19",
"minute": "46",
"second": "11"
}
},
{
"nak_name": "Punarvasu",
"lord": "Jupiter",
"deity": "Aditi",
"element": "Jala",
"symbol": "Bow and Quiver",
"syllables": "के, को, हा, ही",
"pursuit": "Artha",
"gana": "Dev",
"direction": "North",
"guna": "Sattavik",
"body_part": "Finger & Nose",
"color": "Green/Silver",
"nak_number": 7,
"nak_pada": 3,
"end_time": "2025-07-24 01:29:11",
"end_time_seprated": {
"day": "24",
"month": "07",
"year": "2025",
"hour": "01",
"minute": "29",
"second": "11"
}
},
{
"nak_name": "Punarvasu",
"lord": "Jupiter",
"deity": "Aditi",
"element": "Jala",
"symbol": "Bow and Quiver",
"syllables": "के, को, हा, ही",
"pursuit": "Artha",
"gana": "Dev",
"direction": "North",
"guna": "Sattavik",
"body_part": "Finger & Nose",
"color": "Green/Silver",
"nak_number": 7,
"nak_pada": 4,
"end_time": ""
}
]
},
"sun_nakshatras": {
"zodiac_point": [
{
"sign": "Cancer",
"end_time": ""
}
],
"nakshatra_list": [
{
"nak_name": "Pushya",
"end_time": ""
}
],
"nakshatra_pada": [
{
"nak_name": "Pushya",
"lord": "Saturn",
"deity": "Brihaspati",
"element": "Jala",
"symbol": "Cow's Udder",
"syllables": "हु, हे, हो, ड",
"pursuit": "Dharma",
"gana": "Dev",
"direction": "East",
"guna": "Sattavik",
"body_part": "Mouth, Face, connections to facial expressions, Bones, Joints, Elbows",
"color": "Red/Black",
"nak_number": 8,
"nak_pada": 1,
"end_time": "2025-07-23 07:38:11",
"end_time_seprated": {
"day": "23",
"month": "07",
"year": "2025",
"hour": "07",
"minute": "38",
"second": "11"
}
},
{
"nak_name": "Pushya",
"lord": "Saturn",
"deity": "Brihaspati",
"element": "Jala",
"symbol": "Cow's Udder",
"syllables": "हु, हे, हो, ड",
"pursuit": "Dharma",
"gana": "Dev",
"direction": "East",
"guna": "Sattavik",
"body_part": "Mouth, Face, connections to facial expressions, Bones, Joints, Elbows",
"color": "Red/Black",
"nak_number": 8,
"nak_pada": 2,
"end_time": ""
}
]
},
"tithis": [
{
"start_time": "2025-07-22 19:10:16",
"end_time": "2025-07-23 16:58:16",
"number": "14",
"tithi": "Chaturdashi",
"paksha": "Krishna",
"type": "Rikta",
"deity": "Shiva",
"vriddhi": "false",
"kshaya": "false",
"gandanta": [],
"paksha_randhra": {
"start_time": "2025-07-22 19:10:16",
"end_time": "2025-07-22 21:10:16"
}
},
{
"start_time": "2025-07-23 16:59:16",
"end_time": "2025-07-24 15:10:16",
"number": "15",
"tithi": "Amavasya",
"paksha": "Krishna",
"type": "Purna",
"deity": "Pitra",
"vriddhi": "false",
"kshaya": "false",
"gandanta": {
"start_time": "2025-07-24 14:46:16",
"end_time": "2025-07-24 15:10:16"
},
"paksha_randhra": []
}
],
"yogas": [
{
"start_time": "2025-07-23 03:04:16",
"end_time": "2025-07-24 00:21:16",
"yoga_number": "14",
"yoga_name": "Harshana",
"visha_ghatis": []
},
{
"start_time": "2025-07-24 00:21:16",
"end_time": "2025-07-24 21:58:16",
"yoga_number": "15",
"yoga_name": "Vajra",
"visha_ghatis": {
"start_time": "2025-07-24 00:21:16",
"end_time": "2025-07-24 01:33:16"
}
}
],
"karnas": [
{
"start_time": "2025-07-22 19:10:16",
"end_time": "2025-07-23 06:02:16",
"tithi": "Chaturdashi",
"paksha": "Krishna",
"karana_name": "Vishti",
"mobility": "Moveable",
"rulling_planet": "Saturn",
"devata": "Yama",
"nature": "Kroora",
"bhadra": {
"bhadra_puccha": {
"start_time": "2025-07-23 04:50:16",
"end_time": "2025-07-23 06:02:16"
},
"bhadra_mukha": {
"start_time": "2025-07-22 19:10:16",
"end_time": "2025-07-22 21:10:16"
}
},
"bhadra_niwas": [
{
"start_time": "2025-07-22 19:10:16",
"end_time": "2025-07-23 06:02:16",
"zodiac_name": "Gemini",
"bhadra_niwas": "Swarga",
"nature": "Auspicious"
}
]
},
{
"start_time": "2025-07-23 06:03:16",
"end_time": "2025-07-23 16:58:16",
"tithi": "Chaturdashi",
"paksha": "Krishna",
"karana_name": "Shakuni",
"mobility": "Fixed",
"rulling_planet": "Rahu",
"devata": "Kaali",
"nature": "Kroora",
"bhadra": [],
"bhadra_niwas": []
},
{
"start_time": "2025-07-23 16:59:16",
"end_time": "2025-07-24 04:01:16",
"tithi": "Amavasya",
"paksha": "Krishna",
"karana_name": "Chatushpada",
"mobility": "Fixed",
"rulling_planet": "Ketu",
"devata": "Rudra",
"nature": "Kroora",
"bhadra": [],
"bhadra_niwas": []
},
{
"start_time": "2025-07-24 04:02:16",
"end_time": "2025-07-24 15:10:16",
"tithi": "Amavasya",
"paksha": "Krishna",
"karana_name": "Naga",
"mobility": "Fixed",
"rulling_planet": "Rahu",
"devata": "Nagas",
"nature": "Kroora",
"bhadra": [],
"bhadra_niwas": []
}
]
}
}
Code Examples
Below are example calls in multiple languages to help you integrate quickly.
cURL
curl --location 'https://astroapi-1.divineapi.com/indian-api/v2/find-panchang' \
--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-1.divineapi.com/indian-api/v2/find-panchang',
'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-1.divineapi.com/indian-api/v2/find-panchang",
"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-1.divineapi.com/indian-api/v2/find-panchang"
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)
Notes and Best Practices
Always send both Authorization: Bearer {token} and api_key in the request.
Ensure latitude, longitude, and timezone match the actual place to get correct sunrise, sunset, and nakshatra timings.
If you are building a multilingual widget, expose the lan field to the frontend so users can choose their language.
The response contains nested objects like nakshatras, sun_nakshatras, tithis, yogas, and karnas. You can selectively display these based on your product requirement.