search

Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Find Nakshatra API

The Find Nakshatra API provides detailed insights about the lunar constellations (Nakshatras) active during a specific date and location. It returns Nakshatra names, Padas, Lords, Deities, and other astrological attributes that play a vital role in Vedic astrology.


Step-by-Step Postman Testing Integration

For a complete walkthrough on how to test this API using Postman, refer to the official documentation:
Step by Step Find Nakshatra API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-nakshatra-api-using-postman


Supported Language Codes

This API supports multiple Indian languages for localized output. You can specify the language using 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

CodeLanguage
enEnglish
hiHindi
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada

Guide:
Add the lan parameter in your request body to get the Nakshatra details in your preferred language. Default language is 'en'.


Endpoint

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

This endpoint returns Nakshatra details for a specific date, time, and location.


Headers

NameTypeDescription
AuthorizationStringYour API Access Token. Example: Bearer {token}

Request Body

NameTypeRequiredDescription
api_keyStringYesYour Divine API key.
dayIntegerYesDate of Panchang, e.g., 24.
monthIntegerYesMonth of Panchang, e.g., 05.
yearIntegerYesYear of Panchang, e.g., 2023.
placeStringNoPlace name, e.g., New Delhi.
latFloatYesLatitude of the location, e.g., 28.6139.
lonFloatYesLongitude of the location, e.g., 77.2090.
tzoneFloatYesTimezone offset, e.g., 5.5. See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide
lanStringNoLanguage code from the table above (default: 'en').

200: OK Nakshatra Details Fetched Successfully 

{
    "success": 1,
    "data": {
        "sunrise": "2025-07-23 05:58:11",
        "sunset": "2025-07-23 20:46:48",
        "nakshatras": {
            "nakshatra_list": [
                "Aradra",
                "Punarvasu"
            ],
            "nakshatra_pada": [
                {
                    "nak_name": "Aradra",
                    "lord": "Rahu",
                    "deity": "Rudra",
                    "element": "Jala",
                    "symbol": "Tear Drop",
                    "syllables": "कु, घ, ङ, छ",
                    "pursuit": "Kama",
                    "gana": "Manushya",
                    "direction": "West",
                    "guna": "Tamasik",
                    "body_part": "Hair , Eyes , Back & front side of head",
                    "color": "Red",
                    "nak_number": 6,
                    "nak_pada": 4,
                    "end_time": "2025-07-23 08:24:11",
                    "end_time_seprated": {
                        "day": "23",
                        "month": "07",
                        "year": "2025",
                        "hour": "08",
                        "minute": "24",
                        "second": "11"
                    }
                },
                {
                    "nak_name": "Punarvasu",
                    "lord": "Jupiter",
                    "deity": "Aditi",
                    "element": "Jala",
                    "symbol": "Bow and Quiver",
                    "syllables": "के, को, हा, ही",
                    "pursuit": "Artha",
                    "gana": "Dev",
                    "direction": "North",
                    "guna": "Sattavik",
                    "body_part": "Finger & Nose",
                    "color": "Green/Silver",
                    "nak_number": 7,
                    "nak_pada": 1,
                    "end_time": "2025-07-23 14:04:11",
                    "end_time_seprated": {
                        "day": "23",
                        "month": "07",
                        "year": "2025",
                        "hour": "14",
                        "minute": "04",
                        "second": "11"
                    }
                },
                {
                    "nak_name": "Punarvasu",
                    "lord": "Jupiter",
                    "deity": "Aditi",
                    "element": "Jala",
                    "symbol": "Bow and Quiver",
                    "syllables": "के, को, हा, ही",
                    "pursuit": "Artha",
                    "gana": "Dev",
                    "direction": "North",
                    "guna": "Sattavik",
                    "body_part": "Finger & Nose",
                    "color": "Green/Silver",
                    "nak_number": 7,
                    "nak_pada": 2,
                    "end_time": "2025-07-23 19:46:11",
                    "end_time_seprated": {
                        "day": "23",
                        "month": "07",
                        "year": "2025",
                        "hour": "19",
                        "minute": "46",
                        "second": "11"
                    }
                },
                {
                    "nak_name": "Punarvasu",
                    "lord": "Jupiter",
                    "deity": "Aditi",
                    "element": "Jala",
                    "symbol": "Bow and Quiver",
                    "syllables": "के, को, हा, ही",
                    "pursuit": "Artha",
                    "gana": "Dev",
                    "direction": "North",
                    "guna": "Sattavik",
                    "body_part": "Finger & Nose",
                    "color": "Green/Silver",
                    "nak_number": 7,
                    "nak_pada": 3,
                    "end_time": "2025-07-24 01:29:11",
                    "end_time_seprated": {
                        "day": "24",
                        "month": "07",
                        "year": "2025",
                        "hour": "01",
                        "minute": "29",
                        "second": "11"
                    }
                },
                {
                    "nak_name": "Punarvasu",
                    "lord": "Jupiter",
                    "deity": "Aditi",
                    "element": "Jala",
                    "symbol": "Bow and Quiver",
                    "syllables": "के, को, हा, ही",
                    "pursuit": "Artha",
                    "gana": "Dev",
                    "direction": "North",
                    "guna": "Sattavik",
                    "body_part": "Finger & Nose",
                    "color": "Green/Silver",
                    "nak_number": 7,
                    "nak_pada": 4,
                    "end_time": ""
                }
            ]
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

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

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

Always include both Authorization (Bearer token) and api_key in your request.

Ensure latitude, longitude, and timezone values accurately represent the location for precise Nakshatra details.

Responses contain Nakshatra names, Padas, and astrological attributes like lord, deity, element, guna, and more.

Use the lan parameter to fetch results in localized languages.

API requests must be made via HTTPS for security reasons.