Find Yoga API

The Find Yoga API returns the Yoga(s) active on a given date, time, and location as per Indian (Vedic) Astrology. Yogas are one of the five limbs of Panchang and are used to assess auspiciousness, subtle planetary influences, and time-specific qualities.

Step-by-Step Find Yoga API Postman Testing Integration

To learn how to test this API using Postman with real credentials and example payloads, refer to the official guide:
Step by Step Find Yoga API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-yoga-api-using-postman

Supported Language Codes

This API supports multiple Indian languages. You can pass the lan parameter in the request body to get localized data.

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:
If lan is not sent, the response will be in English (en) by default.

API Endpoint

POST https://astroapi-1.divineapi.com/indian-api/v2/find-yoga

This endpoint returns Yoga details (name, number, start/end time, and visha ghatis if any) for the provided date and location.

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 supported list. Default: `en`.

200: OK Yoga details fetched successfully

{
    "success": 1,
    "data": {
        "sunrise": "2023-05-24 05:25:56",
        "sunset": "2023-05-24 19:10:28",
        "yogas": [
            {
                "start_time": "2023-05-24 05:26:20",
                "end_time": "2023-05-24 17:19:20",
                "yoga_number": "10",
                "yoga_name": "Ganda",
                "visha_ghatis": {
                    "start_time": "2023-05-24 05:26:20",
                    "end_time": "2023-05-24 07:50:20"
                }
            },
            {
                "start_time": "2023-05-24 17:19:20",
                "end_time": "2023-05-25 18:08:20",
                "yoga_number": "11",
                "yoga_name": "Vridhi",
                "visha_ghatis": []
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-1.divineapi.com/indian-api/v2/find-yoga' \
--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/v2/find-yoga',
  '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/v2/find-yoga",
  "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/v2/find-yoga"

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.

Ensure the latitude, longitude, and timezone match the actual location to get the correct Yoga timings.

The response may contain multiple Yogas in a day, each with its own start and end time.

visha_ghatis in the response represent sensitive time windows associated with that Yoga.

Use the lan parameter for localized content.

Always call the endpoint over HTTPS for security.