Planetary Positions

Explore the dynamic dance of planets through our Planetary Positions API, providing real-time insights into the cosmic placements that influence astrological interpretations within the Indian tradition.

Step by Step Planetary Positions API Postman Testing Integration

View the Postman Testing Guide

Supported Language Codes

Support Article URL: 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: These languages are supported by this API. You can use them by passing lan in the request body with the value of the language.

API Endpoint

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

Returns Planetary Positions in the response.

Headers

Name	Type	Description
Authorization*	String	Your API Access TokenExample: `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your 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, e.g., 14
min*	Integer	Minute, e.g., 40
sec*	Integer	Second, e.g., 43
gender*	String	Gender, e.g., male
place*	String	Place, e.g., New Delhi
lat*	Float	Latitude, e.g., 28.7041
lon*	Float	Longitude, e.g., 77.1025
tzone*	Float	Timezone, e.g., 5.5Timezone List
lan	String	Language code as per the table above. Default is `en`.

200: OK Planetary Positions Fetched Successfully

{
    "success": 1,
    "data": {
        "date": "2025-07-23",
        "time": "03:45:00",
        "latitude": "43.083714",
        "longitude": "-79.065147",
        "timezone": "-4",
        "planets": [
            {
                "name": "Sun",
                "name_lan": "Sun",
                "full_degree": "96.5115748",
                "speed": "0.9552920",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "6:30:41",
                "sign": "Cancer",
                "sign_no": 4,
                "rashi_lord": "Moon",
                "nakshatra": "Pushya",
                "nakshatra_pada": 1,
                "nakshatra_no": 8,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Mercury",
                "awastha": "Vriddha",
                "karakamsha": "Dara",
                "house": 2,
                "type": "malefic",
                "lord_of": "Third House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Sun.png"
            },
            {
                "name": "Moon",
                "name_lan": "Moon",
                "full_degree": "77.2513346",
                "speed": "14.1780534",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "17:15:4",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 4,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Venus",
                "awastha": "Yuva",
                "karakamsha": "Maatra",
                "house": 1,
                "type": "malefic",
                "lord_of": "Second House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Moon.png"
            },
            {
                "name": "Mercury",
                "name_lan": "Mercury",
                "full_degree": "110.3021979",
                "speed": "-0.4066619",
                "is_retro": "true",
                "is_combusted": "true",
                "longitude": "20:18:7",
                "sign": "Cancer",
                "sign_no": 4,
                "rashi_lord": "Moon",
                "nakshatra": "Ashlesha",
                "nakshatra_pada": 2,
                "nakshatra_no": 9,
                "nakshatra_lord": "Mercury",
                "sub_lord": "Venus",
                "awastha": "Kumar",
                "karakamsha": "Bhratra",
                "house": 2,
                "type": "benefic",
                "lord_of": "First,Fourth House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Mercury.png"
            },
            {
                "name": "Venus",
                "name_lan": "Venus",
                "full_degree": "56.7689001",
                "speed": "1.1429592",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "26:46:8",
                "sign": "Taurus",
                "sign_no": 2,
                "rashi_lord": "Venus",
                "nakshatra": "Mrigashira",
                "nakshatra_pada": 2,
                "nakshatra_no": 5,
                "nakshatra_lord": "Mars",
                "sub_lord": "Jupiter",
                "awastha": "Baal",
                "karakamsha": "Amatya",
                "house": 12,
                "type": "benefic",
                "lord_of": "Twelfth,Fifth House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Venus.png"
            },
            {
                "name": "Mars",
                "name_lan": "Mars",
                "full_degree": "146.7831714",
                "speed": "0.6060293",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "26:46:59",
                "sign": "Leo",
                "sign_no": 5,
                "rashi_lord": "Sun",
                "nakshatra": "Uttara Phalguni",
                "nakshatra_pada": 1,
                "nakshatra_no": 12,
                "nakshatra_lord": "Sun",
                "sub_lord": "Sun",
                "awastha": "Mrityu",
                "karakamsha": "Atma",
                "house": 3,
                "type": "malefic",
                "lord_of": "Eleventh,Sixth House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Mars.png"
            },
            {
                "name": "Jupiter",
                "name_lan": "Jupiter",
                "full_degree": "75.6142000",
                "speed": "0.2197957",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "15:36:51",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 3,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Venus",
                "awastha": "Yuva",
                "karakamsha": "Putra",
                "house": 1,
                "type": "neutral",
                "lord_of": "Seventh,Tenth House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Jupiter.png"
            },
            {
                "name": "Saturn",
                "name_lan": "Saturn",
                "full_degree": "337.6326830",
                "speed": "-0.0170636",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "7:37:57",
                "sign": "Pisces",
                "sign_no": 12,
                "rashi_lord": "Jupiter",
                "nakshatra": "Uttara Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 26,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Ketu",
                "awastha": "Vriddha",
                "karakamsha": "Gnati",
                "house": 10,
                "type": "benefic",
                "lord_of": "Eighth,Ninth House",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Saturn.png"
            },
            {
                "name": "Uranus",
                "name_lan": "Uranus",
                "full_degree": "36.4266973",
                "speed": "0.0351518",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "6:25:36",
                "sign": "Taurus",
                "sign_no": 2,
                "rashi_lord": "Venus",
                "nakshatra": "Krittika",
                "nakshatra_pada": 3,
                "nakshatra_no": 3,
                "nakshatra_lord": "Sun",
                "sub_lord": "Mercury",
                "awastha": "Vriddha",
                "karakamsha": "",
                "house": 12,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Uranus.png"
            },
            {
                "name": "Neptune",
                "name_lan": "Neptune",
                "full_degree": "337.8703452",
                "speed": "-0.0097336",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "7:52:13",
                "sign": "Pisces",
                "sign_no": 12,
                "rashi_lord": "Jupiter",
                "nakshatra": "Uttara Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 26,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Ketu",
                "awastha": "Vriddha",
                "karakamsha": "",
                "house": 10,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Neptune.png"
            },
            {
                "name": "Pluto",
                "name_lan": "Pluto",
                "full_degree": "278.4205667",
                "speed": "-0.0235970",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "8:25:14",
                "sign": "Capricorn",
                "sign_no": 10,
                "rashi_lord": "Saturn",
                "nakshatra": "Uttara Ashada",
                "nakshatra_pada": 4,
                "nakshatra_no": 21,
                "nakshatra_lord": "Sun",
                "sub_lord": "Venus",
                "awastha": "Vriddha",
                "karakamsha": "",
                "house": 8,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Pluto.png"
            },
            {
                "name": "Rahu",
                "name_lan": "Rahu",
                "full_degree": "326.5164966",
                "speed": "-0.0529920",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "26:30:59",
                "sign": "Aquarius",
                "sign_no": 11,
                "rashi_lord": "Saturn",
                "nakshatra": "Purva Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 25,
                "nakshatra_lord": "Jupiter",
                "sub_lord": "Ketu",
                "awastha": "Mrityu",
                "karakamsha": "",
                "house": 9,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Rahu.png"
            },
            {
                "name": "Ketu",
                "name_lan": "Ketu",
                "full_degree": "146.5165",
                "speed": "-0.0529920",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "26:30:59",
                "sign": "Leo",
                "sign_no": 5,
                "rashi_lord": "Sun",
                "nakshatra": "Purva Phalguni",
                "nakshatra_pada": 4,
                "nakshatra_no": 11,
                "nakshatra_lord": "Venus",
                "sub_lord": "Ketu",
                "awastha": "Mrityu",
                "karakamsha": "",
                "house": 3,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Ketu.png"
            },
            {
                "name": "Ascendant",
                "name_lan": "Ascendant",
                "full_degree": "67.9760792",
                "speed": "325.2802250",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "7:58:33",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 1,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Rahu",
                "awastha": "Kumar",
                "karakamsha": "",
                "house": 1,
                "type": "",
                "lord_of": "",
                "image": "https://divineapi.com/public/api-assets/assets/images/planets/Ascendant.png"
            }
        ]
    }
}

Example Integrations

Below are examples of how to call this API in different environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--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/planetary-positions',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    '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", "Test");
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/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/planetary-positions"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'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, data=payload)

print(response.text)

Notes

This API returns classical Vedic parameters like sign, nakshatra, nakshatra pada, rashi lord, and also outer planets (Uranus, Neptune, Pluto) for extended analysis.

Some fields such as karakamsha, type, or lord_of may be blank for outer/modern planets as per Vedic conventions.

Always pass the correct tzone, lat, and lon to get accurate planetary longitudes.