Find Karana API
The Find Karana API provides detailed insights into the Karana(s) for a specific date and location. In Indian Astrology, a Karana represents half of a lunar day and carries unique energetic influences that affect daily activities and auspicious timings.
Step-by-Step Find Karana API Postman Testing Integration
Refer to the official guide for detailed Postman testing instructions:
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-karana-api-using-postman
Supported Language Codes
The API supports multiple Indian languages. You can receive the response in your preferred language by passing the lan parameter in the request body.
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:
If lan is not provided, the default response language is English (en).
API Endpoint
POST https://astroapi-1.divineapi.com/indian-api/v1/find-karana
This endpoint returns the Karana details for a given date, latitude, longitude, and timezone.
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, e.g., 24. |
| month | Integer | Yes | Month of Panchang, e.g., 05. |
| year | Integer | Yes | Year of Panchang, 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. Refer to the Timezone Guide. |
| lan | String | No | Language code from the supported list. Default is 'en'. |
200: OK Karana detaiks fetched successfully
{
"success": 1,
"data": {
"sunrise": "2023-05-24 05:25:56",
"sunset": "2023-05-24 19:10:28",
"karnas": [
{
"start_time": "2023-05-24 00:58:44",
"end_time": "2023-05-24 13:56:44",
"tithi": "Panchmi",
"paksha": "Shukla",
"karana_name": "Bav",
"mobility": "Moveable",
"rulling_planet": "Sun",
"devata": "Indra",
"nature": "Saumya",
"bhadra": [],
"bhadra_niwas": []
},
{
"start_time": "2023-05-24 13:57:44",
"end_time": "2023-05-25 03:00:44",
"tithi": "Panchmi",
"paksha": "Shukla",
"karana_name": "Balav",
"mobility": "Moveable",
"rulling_planet": "Moon",
"devata": "Brahma",
"nature": "Saumya",
"bhadra": [],
"bhadra_niwas": []
},
{
"start_time": "2023-05-25 03:01:44",
"end_time": "2023-05-25 16:08:44",
"tithi": "Shasthi",
"paksha": "Shukla",
"karana_name": "Kaulava",
"mobility": "Moveable",
"rulling_planet": "Mars",
"devata": "Mitra",
"nature": "Saumya",
"bhadra": [],
"bhadra_niwas": []
}
]
}
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-1.divineapi.com/indian-api/v1/find-karana' \
--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"'Node.js
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-1.divineapi.com/indian-api/v1/find-karana',
'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/v1/find-karana",
"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/v1/find-karana"
payload = {'api_key': 'your API Key',
'day': '03',
'month': '03',
'year': '2023',
'lat': '34.05223',
'lon': '-118.24368',
'tzone': '-7',
'lan': 'en'}
headers = {
'Authorization': 'Bearer your API Access Token'
}
response = requests.request("POST", url, headers=headers)
print(response.text)
Notes and Best Practices
Both Authorization (Bearer token) and api_key are mandatory for every request.
Ensure that latitude, longitude, and timezone values correspond to the target location for accurate Karana computation.
The response includes multiple Karana segments for the day with their corresponding start and end times.
Attributes such as mobility, ruling planet, devata, and nature provide deeper astrological context for each Karana.
Use the lan parameter for multilingual support.
Always send API requests over HTTPS to maintain data security.