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.

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
lan	String	Language en/hi, 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"
                }
            }
        ]
    }
}

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)