Find Nivas and Shool API

The Find Nivas and Shool API provides astrological insights into the direction of energies (Shool) and dwellings (Nivas) as interpreted through traditional Indian astrology. It helps identify auspicious directions, planetary influences, and the flow of cosmic energies associated with a specific date and location, offering valuable guidance for planning activities and rituals.

Step-by-Step Find Nivas and Shool API Postman Testing Integration

For a complete walkthrough on testing this API in Postman, refer to the official documentation:

Step by Step Find Nivas and Shool API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-nivas-and-shool-api-using-postman

Supported Language Codes

You can fetch responses in multiple Indian languages by passing the lan parameter in the request body.

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

Guide:
If the lan parameter is not specified, the API will default to English (en).

API Endpoint

POST https://astroapi-2.divineapi.com/indian-api/v1/find-nivas-and-shool

This endpoint returns the Nivas (dwelling) and Shool (directional influence) data based on the given date and location.

Headers

Request Body

200: OK Nivas and Shool details fetched successfully

{
    "success": 1,
    "data": {
        "disha_shool": "North",
        "rahu_vaas": "South West",
        "shiva_vaas": [
            "Kailash upto 03:00:20 AM",
            "Seated on Nandi"
        ],
        "agni_vaas": [
            "Paatal (Mantle)upto 03:00:20 AM",
            "Prithvi (Earth)"
        ],
        "yogini_vaas": [
            "South upto 03:00:20 AM",
            "West"
        ],
        "chandra_vaas": [
            "West upto 08:26:20 AM",
            "North"
        ],
        "homahuti": [
            "Mercury"
        ],
        "kumbha_chakra": [
            "East (Purva)",
            "South (Dakshin)"
        ]
    }
}

Notes on Response Fields

disha_shool: Indicates the primary inauspicious direction (Shool) for the day, which should be avoided when traveling or starting key activities.

rahu_vaas: Shows the direction of Rahu’s influence, often associated with confusion or illusion.

shiva_vaas: Denotes Lord Shiva’s cosmic dwelling for the day, indicating divine energy orientation.

agni_vaas: Refers to the elemental placement of the Fire God (Agni), symbolizing energy and vitality.

yogini_vaas: Represents the Yoginis’ directional influence—symbolic of feminine cosmic energy.

chandra_vaas: Indicates the Moon’s directional residence and its emotional or mental effect.

homahuti: Suggests the ruling planetary energy governing sacrificial offerings or rituals.

kumbha_chakra: Represents the energy flow within the zodiacal wheel (Kumbha Chakra), showing directional balance.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-2.divineapi.com/indian-api/v1/find-nivas-and-shool' \
--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-2.divineapi.com/indian-api/v1/find-nivas-and-shool',
  '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-2.divineapi.com/indian-api/v1/find-nivas-and-shool",
  "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-2.divineapi.com/indian-api/v1/find-nivas-and-shool"

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 include both Authorization and api_key parameters for secure API access.

Ensure lat, lon, and tzone accurately reflect the user’s geographical coordinates for correct results.

Some fields, such as vaas or chakra, may return multiple values or arrays; handle these dynamically in your integration.

Responses are time-sensitive; incorrect date or time-zone may alter results.

Always use HTTPS for secure communication.

For multilingual support, use the lan field to localize the response to your user’s preferred language.