Find Auspicious Timings API

The Find Auspicious Timings API is part of the Panchang API suite and is used to fetch precise start and end times of important auspicious periods in a day as per Vedic astrology. This includes Brahma Muhurta, Abhijit Muhurta, Godhuli Muhurta, Sandhya times, and special yogas like Sarvartha Siddhi Yoga and Amrit Kalam. It is ideal for applications that help users select favorable timings for puja, meditation, business, and personal events.

Step-by-Step Find Auspicious Timings API Postman Testing Integration

You can follow the official walkthrough to test this API using Postman:

Step by Step Find Auspicious Timings API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-auspicious-timings-api-using-postman

Supported Language Codes

This API supports multiple languages. You can get the response in a different language by passing the lan field in the request body.

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

Guide: If lan is not sent, the default response language is en.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/auspicious-timings

This endpoint returns auspicious timing windows for the given date and location.

Headers

Request Body

200: OK Auspicious Timings fetched successfully

{
    "success": 1,
    "data": {
        "date": "2023-05-24",
        "sunrise": "2023-05-24 05:25:56",
        "sunset": "2023-05-24 19:10:28",
        "brahma_muhurta": {
            "start_time": "2023-05-24 04:03:56",
            "end_time": "2023-05-24 04:44:56"
        },
        "abhijit_muhurta": [],
        "godhuli_muhurta": {
            "start_time": "2023-05-24 19:10:28",
            "end_time": "2023-05-24 19:30:58"
        },
        "pratah_sandhya": {
            "start_time": "2023-05-24 04:24:26",
            "end_time": "2023-05-24 05:25:56"
        },
        "sayahana_sandhya": {
            "start_time": "2023-05-24 19:10:28",
            "end_time": "2023-05-24 20:11:58"
        },
        "nishita_muhurta": {
            "start_time": "2023-05-24 23:57:28",
            "end_time": "2023-05-25 00:38:28"
        },
        "vijay_muhurta": {
            "start_time": "2023-05-24 14:35:56",
            "end_time": "2023-05-24 15:30:56"
        },
        "sarvartha_siddhi_yoga": [],
        "amrit_siddhi_yoga": [],
        "siddha_yoga": [],
        "tri_pushkara_yoga": [],
        "ravi_yoga": [
            {
                "start_time": "2023-05-24 15:06:44",
                "end_time": "2023-05-25 05:25:35"
            }
        ],
        "amrit_kalam": {
            "start_time": "2023-05-24 12:27:02",
            "end_time": "2023-05-24 14:12:50"
        }
    }
}

Notes on Response Fields

brahma_muhurta: Pre-dawn spiritual time, considered highly auspicious for meditation, mantra, and sadhana.

abhijit_muhurta: Midday auspicious period; may be empty if not applicable for that day/location.

godhuli_muhurta: Evening auspicious period around sunset.

pratah_sandhya and sayahana_sandhya: Morning and evening sandhya times.

nishita_muhurta: Midnight auspicious span.

vijay_muhurta: Good for success-related undertakings.

sarvartha_siddhi_yoga, amrit_siddhi_yoga, siddha_yoga, tri_pushkara_yoga: These can be arrays and may be empty depending on the date.

ravi_yoga: May return one or more periods.

amrit_kalam: Short but highly favorable period.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/auspicious-timings' \
--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-3.divineapi.com/indian-api/v1/auspicious-timings',
  '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-3.divineapi.com/indian-api/v1/auspicious-timings",
  "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-3.divineapi.com/indian-api/v1/auspicious-timings"

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)

Best Practices

Always send both Authorization: Bearer {Your Auth Token} and api_key in every request.

Make sure lat, lon, and tzone match the user’s actual location, since auspicious timings are location-specific.

Some fields may return empty arrays ([]) for certain dates; handle this gracefully in your UI.

Always use HTTPS for secure communication.

Use the lan parameter to localize the auspicious timing labels for your target audience.