Month Tithi List

The Month Tithi List API returns day-wise Tithi details for an entire month based on the selected location.

API Endpoint

POST https://astroapi-8.divineapi.com/indian-api/v1/month-tithi-list

Returns Tithi details for all days of the selected month.

Headers

Name	Type	Description
Authorization*	String	your API Access Token, e.g., `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your API key
month*	Integer	Month number, e.g., `05`
year*	Integer	Year, e.g., `2023`
place	String	Place name, e.g., `New Delhi`
lat*	Float	Latitude, e.g., `28.6139`
lon*	Float	Longitude, e.g., `77.2090`
tzone*	Float	Timezone, e.g., `5.5`

200: OK Month Tithi List fetched successfully

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": [
        {
            "tithi_no": 11,
            "tithi": "Ekadashi",
            "paksha": "Shukla",
            "start_time": "2023-04-30 20:30:00",
            "end_time": "2023-05-01 22:11:00"
        },
        {
            "tithi_no": 12,
            "tithi": "Dwadashi",
            "paksha": "Shukla",
            "start_time": "2023-05-01 22:11:00",
            "end_time": "2023-05-02 23:19:00"
        },
        {
            "tithi_no": 13,
            "tithi": "Tryodashi",
            "paksha": "Shukla",
            "start_time": "2023-05-02 23:19:00",
            "end_time": "2023-05-03 23:51:00"
        },
        {
            "tithi_no": 14,
            "tithi": "Chaturdashi",
            "paksha": "Shukla",
            "start_time": "2023-05-03 23:51:00",
            "end_time": "2023-05-04 23:45:00"
        },
        {
            "tithi_no": 15,
            "tithi": "Purnima",
            "paksha": "Shukla",
            "start_time": "2023-05-04 23:45:00",
            "end_time": "2023-05-05 23:05:00"
        },
        {
            "tithi_no": 16,
            "tithi": "Pratipada",
            "paksha": "Krishna",
            "start_time": "2023-05-05 23:05:00",
            "end_time": "2023-05-06 21:53:00"
        },
        {
            "tithi_no": 17,
            "tithi": "Dwitiya",
            "paksha": "Krishna",
            "start_time": "2023-05-06 21:53:00",
            "end_time": "2023-05-07 20:16:00"
        },
        {
            "tithi_no": 18,
            "tithi": "Tritiya",
            "paksha": "Krishna",
            "start_time": "2023-05-07 20:16:00",
            "end_time": "2023-05-08 18:20:00"
        },
        {
            "tithi_no": 19,
            "tithi": "Chaturthi",
            "paksha": "Krishna",
            "start_time": "2023-05-08 18:20:00",
            "end_time": "2023-05-09 16:09:00"
        },
        {
            "tithi_no": 20,
            "tithi": "Panchmi",
            "paksha": "Krishna",
            "start_time": "2023-05-09 16:09:00",
            "end_time": "2023-05-10 13:51:00"
        },
        {
            "tithi_no": 21,
            "tithi": "Shasthi",
            "paksha": "Krishna",
            "start_time": "2023-05-10 13:51:00",
            "end_time": "2023-05-11 11:28:00"
        },
        {
            "tithi_no": 22,
            "tithi": "Saptami",
            "paksha": "Krishna",
            "start_time": "2023-05-11 11:28:00",
            "end_time": "2023-05-12 09:08:00"
        },
        {
            "tithi_no": 23,
            "tithi": "Ashtami",
            "paksha": "Krishna",
            "start_time": "2023-05-12 09:08:00",
            "end_time": "2023-05-13 06:52:00"
        },
        {
            "tithi_no": 24,
            "tithi": "Navami",
            "paksha": "Krishna",
            "start_time": "2023-05-13 06:52:00",
            "end_time": "2023-05-14 04:44:00"
        },
        {
            "tithi_no": 25,
            "tithi": "Dashami",
            "paksha": "Krishna",
            "start_time": "2023-05-14 04:44:00",
            "end_time": "2023-05-15 02:47:00"
        },
        {
            "tithi_no": 26,
            "tithi": "Ekadashi",
            "paksha": "Krishna",
            "start_time": "2023-05-15 02:47:00",
            "end_time": "2023-05-16 01:04:00"
        },
        {
            "tithi_no": 27,
            "tithi": "Dwadashi",
            "paksha": "Krishna",
            "start_time": "2023-05-16 01:04:00",
            "end_time": "2023-05-16 23:37:00"
        },
        {
            "tithi_no": 28,
            "tithi": "Tryodashi",
            "paksha": "Krishna",
            "start_time": "2023-05-16 23:37:00",
            "end_time": "2023-05-17 22:30:00"
        },
        {
            "tithi_no": 29,
            "tithi": "Chaturdashi",
            "paksha": "Krishna",
            "start_time": "2023-05-17 22:30:00",
            "end_time": "2023-05-18 21:44:00"
        },
        {
            "tithi_no": 30,
            "tithi": "Amavasya",
            "paksha": "Krishna",
            "start_time": "2023-05-18 21:44:00",
            "end_time": "2023-05-19 21:24:00"
        },
        {
            "tithi_no": 1,
            "tithi": "Pratipada",
            "paksha": "Shukla",
            "start_time": "2023-05-19 21:24:00",
            "end_time": "2023-05-20 21:32:00"
        },
        {
            "tithi_no": 2,
            "tithi": "Dwitiya",
            "paksha": "Shukla",
            "start_time": "2023-05-20 21:32:00",
            "end_time": "2023-05-21 22:10:00"
        },
        {
            "tithi_no": 3,
            "tithi": "Tritiya",
            "paksha": "Shukla",
            "start_time": "2023-05-21 22:10:00",
            "end_time": "2023-05-22 23:20:00"
        },
        {
            "tithi_no": 4,
            "tithi": "Chaturthi",
            "paksha": "Shukla",
            "start_time": "2023-05-22 23:20:00",
            "end_time": "2023-05-24 00:59:00"
        },
        {
            "tithi_no": 5,
            "tithi": "Panchmi",
            "paksha": "Shukla",
            "start_time": "2023-05-24 00:59:00",
            "end_time": "2023-05-25 03:02:00"
        },
        {
            "tithi_no": 6,
            "tithi": "Shasthi",
            "paksha": "Shukla",
            "start_time": "2023-05-25 03:02:00",
            "end_time": "2023-05-26 05:21:00"
        },
        {
            "tithi_no": 7,
            "tithi": "Saptami",
            "paksha": "Shukla",
            "start_time": "2023-05-26 05:21:00",
            "end_time": "2023-05-27 07:44:00"
        },
        {
            "tithi_no": 8,
            "tithi": "Ashtami",
            "paksha": "Shukla",
            "start_time": "2023-05-27 07:44:00",
            "end_time": "2023-05-28 09:58:00"
        },
        {
            "tithi_no": 9,
            "tithi": "Navami",
            "paksha": "Shukla",
            "start_time": "2023-05-28 09:58:00",
            "end_time": "2023-05-29 11:50:00"
        },
        {
            "tithi_no": 10,
            "tithi": "Dashami",
            "paksha": "Shukla",
            "start_time": "2023-05-29 11:50:00",
            "end_time": "2023-05-30 13:09:00"
        },
        {
            "tithi_no": 11,
            "tithi": "Ekadashi",
            "paksha": "Shukla",
            "start_time": "2023-05-30 13:09:00",
            "end_time": "2023-05-31 13:47:00"
        },
        {
            "tithi_no": 12,
            "tithi": "Dwadashi",
            "paksha": "Shukla",
            "start_time": "2023-05-31 13:47:00",
            "end_time": "2023-06-01 13:40:00"
        }
    ]
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/indian-api/v1/month-tithi-list' \
--header 'Authorization: Bearer Your auth token' \
--form 'api_key="Your API key"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/indian-api/v1/month-tithi-list',
  'headers': {
    'Authorization': 'Bearer Your auth token'
  },
  formData: {
    'api_key': 'Your API key',
    'month': '05',
    'year': '2023',
    'place': 'New Delhi',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5'
  }
};
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("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");

var settings = {
  "url": "https://astroapi-8.divineapi.com/indian-api/v1/month-tithi-list",
  "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-8.divineapi.com/indian-api/v1/month-tithi-list"

payload = {'api_key': 'Your API key',
'month': '05',
'year': '2023',
'place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}
files=[

]
headers = {
  'Authorization': 'Bearer Your auth token'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Implementation Notes

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.

Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).

Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.

Test via Postman before production use and always use HTTPS for secure communication.