Find Tithi API
The Find Tithi API provides detailed information about lunar days (Tithis) based on a given date, time, and location. Each Tithi represents a distinct phase of the Moon and plays a crucial role in Hindu Panchang and astrology-based applications.
Step-by-Step Find Tithi API Postman Testing Integration
For a complete walkthrough on how to test this API using Postman, refer to the official guide:
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-tithi-api-using-postman
Supported Language Codes
This API supports multiple Indian languages. You can use the lan parameter to receive responses in different languages.
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:
Pass the lan parameter in the request body to receive translated responses. Default language is 'en'.
API Endpoint
POST https://astroapi-1.divineapi.com/indian-api/v1/find-tithi
This endpoint returns the Tithi details including start and end times, Tithi name, number, deity, and other related attributes.
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. See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide |
| lan | String | No | Language code from the supported list (default 'en'). |
200: OK Tithi details fetched successfully
{
"success": 1,
"data": {
"sunrise": "2023-05-24 05:25:56",
"sunset": "2023-05-24 19:10:28",
"tithis": [
{
"start_time": "2023-05-24 00:58:44",
"end_time": "2023-05-25 03:00:44",
"number": "5",
"tithi": "Panchmi",
"paksha": "Shukla",
"type": "Purna",
"deity": "Naga",
"vriddhi": "false",
"kshaya": "false",
"gandanta": {
"start_time": "2023-05-25 02:36:44",
"end_time": "2023-05-25 03:00:44"
},
"paksha_randhra": []
},
{
"start_time": "2023-05-25 03:01:44",
"end_time": "2023-05-26 05:19:44",
"number": "6",
"tithi": "Shasthi",
"paksha": "Shukla",
"type": "Nanda",
"deity": "Kartikeya",
"vriddhi": "false",
"kshaya": "false",
"gandanta": {
"start_time": "2023-05-25 03:01:44",
"end_time": "2023-05-25 03:25:44"
},
"paksha_randhra": {
"start_time": "2023-05-25 03:01:44",
"end_time": "2023-05-25 06:37:44"
}
}
]
}
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-1.divineapi.com/indian-api/v1/find-tithi' \
--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-tithi',
'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-tithi",
"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-tithi"
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
Both Authorization (Bearer token) and api_key are mandatory in every request.
Ensure correct latitude, longitude, and timezone values to get accurate Tithi details.
The API provides details about the start and end time of each Tithi along with deity, type, paksha, and special conditions such as Gandanta and Paksha Randhra.
Use the lan parameter to get localized results.
All API requests must be sent via HTTPS for data security.