Find Tithi

Navigate the lunar phases seamlessly with our 'Tithi' API, providing crucial insights into the evolving interplay between the Sun and the Moon within the realm of Indian Astrology.

Step by Step Find Tithi API Postman Testing Integration

Supported Language Codes:

Support Article URL - https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language

en For English

hi For Hindi

bn For Bengali

ma For Marathi

tm For Tamil

tl For Telugu

ml For Malayalam

kn For Kannada

Guide: These languages are supported by this API. You can use by passing "lan" in body with a value of the language.

POST https://astroapi-1.divineapi.com/indian-api/v1/find-tithi

Returns tithi details in response.

Headers

Name	Type	Description
Authorization*	String	your API Access Token eg: Bearer {token}

Request Body

Name	Type	Description
api_key*	String	your API key
day*	Integer	day of panchang, eg: 24
month*	Integer	month of panchang, eg: 05
year*	Integer	year of panchang, eg: 2023
place	String	place, ex: New Delhi
lat*	Float	latitude, eg: 28.6139
lon*	Float	longitude, eg: 77.2090
tzone*	Float	timezone, eg: 5.5 Timezone List
lan	String	Language code as per the table above, default is '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"
                }
            }
        ]
    }
}

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python:

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"'

NodeJS

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)