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-positionsReturns 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. |
| node_type | String | truenode or meannode, default is meannode |
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.