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:
Step by Step Find Tithi API Postman Testing Integration
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 Divine 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.