Planetary Positions API

The Planetary Positions API provides planetary data for Jaimini Astrology, revealing the positions, degrees, nakshatras, and karakamsa significations of each planet and house. This API helps interpret the spiritual and material influences of celestial bodies within the Jaimini system of Indian Astrology.

Step-by-Step Planetary Positions API Postman Testing Integration

You can follow the official guide here:

Step by Step Planetary Positions API Postman Testing Integration

Supported Language Codes

Source:
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

Pass lan in the request body to get the response in that language. Default is en.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions

This endpoint returns detailed planetary position data in response.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your Divine API key.
full_name*	String	Full name, e.g. Rahul Kumar.
day*	Integer	Date of birth, e.g. 24.
month*	Integer	Month of birth, e.g. 05.
year*	Integer	Year of birth, e.g. 2023.
hour*	Integer	Hour of birth (24-hour format), e.g. 14.
min*	Integer	Minute, e.g. 40.
sec*	Integer	Second, e.g. 43.
gender*	String	Gender, e.g. male.
place*	String	Place of birth, e.g. New Delhi.
lat*	Float	Latitude, e.g. 28.7041.
lon*	Float	Longitude, e.g. 77.1025.
tzone*	Float	Timezone, e.g. 5.5. Timezone List
lan	String	Language code as per the table above. Default is `en`.

200: OK Jaimini Astrology Planetary Positions Fetched Successfully

{
    "success": 1,
    "data": [
        {
            "name": "Ascendant",
            "name_lan": "Ascendant",
            "full_degree": "67.9760792",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "7:58:34",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 1,
            "nakshatra_no": 6,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Sun",
            "name_lan": "Sun",
            "full_degree": "96.5115748",
            "sign": "Cancer",
            "sign_no": 4,
            "longitude": "6:30:42",
            "house": 2,
            "nakshatra": "Pushya",
            "nakshatra_pada": 1,
            "nakshatra_no": 8,
            "karakamsha": "Darakaraka",
            "karakamsha_functionality": "Spouse/Partners"
        },
        {
            "name": "Moon",
            "name_lan": "Moon",
            "full_degree": "77.2513346",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "17:15:5",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 4,
            "nakshatra_no": 6,
            "karakamsha": "Matrukaraka",
            "karakamsha_functionality": "Mother/Immovable Assets/Vehicles"
        },
        {
            "name": "Mars",
            "name_lan": "Mars",
            "full_degree": "146.7831714",
            "sign": "Leo",
            "sign_no": 5,
            "longitude": "26:46:59",
            "house": 3,
            "nakshatra": "Uttara Phalguni",
            "nakshatra_pada": 1,
            "nakshatra_no": 12,
            "karakamsha": "Atmakaraka",
            "karakamsha_functionality": "Self"
        },
        {
            "name": "Mercury",
            "name_lan": "Mercury",
            "full_degree": "110.3021979",
            "sign": "Cancer",
            "sign_no": 4,
            "longitude": "20:18:8",
            "house": 2,
            "nakshatra": "Ashlesha",
            "nakshatra_pada": 2,
            "nakshatra_no": 9,
            "karakamsha": "Bhratrukaraka",
            "karakamsha_functionality": "Brothers/coworkers/friends"
        },
        {
            "name": "Venus",
            "name_lan": "Venus",
            "full_degree": "56.7689001",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "26:46:8",
            "house": 12,
            "nakshatra": "Mrigashira",
            "nakshatra_pada": 2,
            "nakshatra_no": 5,
            "karakamsha": "Amatyakaraka",
            "karakamsha_functionality": "Ministers and Advisors"
        },
        {
            "name": "Jupiter",
            "name_lan": "Jupiter",
            "full_degree": "75.6142000",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "15:36:51",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 3,
            "nakshatra_no": 6,
            "karakamsha": "Putrakaraka",
            "karakamsha_functionality": "Children/Education/Creative Abilities"
        },
        {
            "name": "Saturn",
            "name_lan": "Saturn",
            "full_degree": "337.6326830",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "7:37:58",
            "house": 10,
            "nakshatra": "Uttara Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 26,
            "karakamsha": "Gnatikaraka",
            "karakamsha_functionality": "Debts/Fears/Loss/Faliures"
        },
        {
            "name": "Rahu",
            "name_lan": "Rahu",
            "full_degree": "326.5164966",
            "sign": "Aquarius",
            "sign_no": 11,
            "longitude": "26:30:59",
            "house": 9,
            "nakshatra": "Purva Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 25,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Ketu",
            "name_lan": "Ketu",
            "full_degree": 146.51649659999998,
            "sign": "Leo",
            "sign_no": 5,
            "longitude": "26:30:59",
            "house": 3,
            "nakshatra": "Purva Phalguni",
            "nakshatra_pada": 4,
            "nakshatra_no": 11,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Uranus",
            "name_lan": "Uranus",
            "full_degree": "36.4266973",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "6:25:36",
            "house": 12,
            "nakshatra": "Krittika",
            "nakshatra_pada": 3,
            "nakshatra_no": 3,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Neptune",
            "name_lan": "Neptune",
            "full_degree": "337.8703452",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "7:52:13",
            "house": 10,
            "nakshatra": "Uttara Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 26,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Pluto",
            "name_lan": "Pluto",
            "full_degree": "278.4205667",
            "sign": "Capricorn",
            "sign_no": 10,
            "longitude": "8:25:14",
            "house": 8,
            "nakshatra": "Uttara Ashada",
            "nakshatra_pada": 4,
            "nakshatra_no": 21,
            "karakamsha": "",
            "karakamsha_functionality": ""
        }
    ]
}

The response includes the sign, degree, nakshatra, and karakamsha significance for each planet in Jaimini astrology.

Example Integrations

Below are examples of how you might call this API using different programming languages and environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Rahul kumar"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi "' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Rahul kumar',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi ',
    'lat': '28.7041',
    'lon': '77.1025',
    '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("full_name", "Rahul kumar");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi ");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions",
  "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/v2/jaimini-astrology/planetary-positions"

payload = {'api_key': '{Your API Key}',
'full_name': 'Rahul kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi ',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

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

print(response.text)