KP Planetary Positions API

The KP Planetary Positions API provides detailed planetary data based on Krishnamurti Paddhati (KP) principles. It delivers real-time planetary positions, including sub-lords, nakshatra divisions, and house placements—helping astrologers achieve deeper predictive precision in chart analysis.

Step-by-Step KP Planetary Positions API Postman Testing Integration

Refer to the detailed setup guide to test this API in Postman:
https://support.divineapi.com/indian-astrology-apis/testing-kundali-api-kp-planetary-positions-api-using-postman

Supported Language Codes

Reference Article:
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:
Use the lan parameter in your request body to set your preferred response language. Default language is English (en).

API Endpoint

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

This endpoint calculates the KP-style planetary positions based on provided birth details.

Headers

Name	Type	Description
Authorization	String	Your API access token. Example: `Bearer {token}`

Request Body

Name	Type	Required	Description
api_key	String	Yes	Your API key.
full_name	String	Yes	Full name, e.g., `Rahul Kumar`.
day	Integer	Yes	Date of birth, e.g., `24`.
month	Integer	Yes	Month of birth, e.g., `05`.
year	Integer	Yes	Year of birth, e.g., `2023`.
hour	Integer	Yes	Hour (24-hour format), e.g., `14`.
min	Integer	Yes	Minute, e.g., `40`.
sec	Integer	Yes	Second, e.g., `43`.
gender	String	Yes	Gender, e.g., `male`.
place	String	Yes	Birthplace, e.g., `New Delhi`.
lat	Float	Yes	Latitude, e.g., `28.7041`.
lon	Float	Yes	Longitude, e.g., `77.1025`.
tzone	Float	Yes	Timezone, e.g., `5.5`. Refer to Timezone List.
lan	String	No	Response language. Default is English (`en`).

200: OK Planets KP 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",
                "full_degree": "96.6084271",
                "speed": "0.9552920",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "6:36:30",
                "sign": "Cancer",
                "sign_no": 4,
                "rashi_lord": "Moon",
                "nakshatra": "Pushya",
                "nakshatra_pada": 1,
                "nakshatra_no": 8,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Mercury",
                "sub_sub_lord": "Rahu",
                "house": 2
            },
            {
                "name": "Moon",
                "full_degree": "77.3481869",
                "speed": "14.1780534",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "17:20:53",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 4,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Venus",
                "sub_sub_lord": "Ketu",
                "house": 1
            },
            {
                "name": "Mercury",
                "full_degree": "110.3990502",
                "speed": "-0.4066619",
                "is_retro": "true",
                "is_combusted": "true",
                "longitude": "20:23:56",
                "sign": "Cancer",
                "sign_no": 4,
                "rashi_lord": "Moon",
                "nakshatra": "Ashlesha",
                "nakshatra_pada": 2,
                "nakshatra_no": 9,
                "nakshatra_lord": "Mercury",
                "sub_lord": "Venus",
                "sub_sub_lord": "Rahu",
                "house": 2
            },
            {
                "name": "Venus",
                "full_degree": "56.8657524",
                "speed": "1.1429592",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "26:51:56",
                "sign": "Taurus",
                "sign_no": 2,
                "rashi_lord": "Venus",
                "nakshatra": "Mrigashira",
                "nakshatra_pada": 2,
                "nakshatra_no": 5,
                "nakshatra_lord": "Mars",
                "sub_lord": "Jupiter",
                "sub_sub_lord": "Mercury",
                "house": 12
            },
            {
                "name": "Mars",
                "full_degree": "146.8800236",
                "speed": "0.6060293",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "26:52:48",
                "sign": "Leo",
                "sign_no": 5,
                "rashi_lord": "Sun",
                "nakshatra": "Uttara Phalguni",
                "nakshatra_pada": 1,
                "nakshatra_no": 12,
                "nakshatra_lord": "Sun",
                "sub_lord": "Sun",
                "sub_sub_lord": "Rahu",
                "house": 3
            },
            {
                "name": "Jupiter",
                "full_degree": "75.7110523",
                "speed": "0.2197957",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "15:42:39",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 3,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Venus",
                "sub_sub_lord": "Moon",
                "house": 1
            },
            {
                "name": "Saturn",
                "full_degree": "337.7295353",
                "speed": "-0.0170636",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "7:43:46",
                "sign": "Pisces",
                "sign_no": 12,
                "rashi_lord": "Jupiter",
                "nakshatra": "Uttara Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 26,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Ketu",
                "sub_sub_lord": "Rahu",
                "house": 10
            },
            {
                "name": "Uranus",
                "full_degree": "36.5235496",
                "speed": "0.0351518",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "6:31:24",
                "sign": "Taurus",
                "sign_no": 2,
                "rashi_lord": "Venus",
                "nakshatra": "Krittika",
                "nakshatra_pada": 3,
                "nakshatra_no": 3,
                "nakshatra_lord": "Sun",
                "sub_lord": "Mercury",
                "sub_sub_lord": "Jupiter",
                "house": 12
            },
            {
                "name": "Neptune",
                "full_degree": "337.9671975",
                "speed": "-0.0097336",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "7:58:1",
                "sign": "Pisces",
                "sign_no": 12,
                "rashi_lord": "Jupiter",
                "nakshatra": "Uttara Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 26,
                "nakshatra_lord": "Saturn",
                "sub_lord": "Ketu",
                "sub_sub_lord": "Saturn",
                "house": 10
            },
            {
                "name": "Pluto",
                "full_degree": "278.5174190",
                "speed": "-0.0235970",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "8:31:2",
                "sign": "Capricorn",
                "sign_no": 10,
                "rashi_lord": "Saturn",
                "nakshatra": "Uttara Ashada",
                "nakshatra_pada": 4,
                "nakshatra_no": 21,
                "nakshatra_lord": "Sun",
                "sub_lord": "Venus",
                "sub_sub_lord": "Mars",
                "house": 8
            },
            {
                "name": "Rahu",
                "full_degree": "326.6133489",
                "speed": "-0.0529920",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "26:36:48",
                "sign": "Aquarius",
                "sign_no": 11,
                "rashi_lord": "Saturn",
                "nakshatra": "Purva Bhadrapada",
                "nakshatra_pada": 2,
                "nakshatra_no": 25,
                "nakshatra_lord": "Jupiter",
                "sub_lord": "Venus",
                "sub_sub_lord": "Venus",
                "house": 9
            },
            {
                "name": "Ketu",
                "full_degree": "146.61335",
                "speed": "-0.0529920",
                "is_retro": "true",
                "is_combusted": "false",
                "longitude": "26:36:48",
                "sign": "Leo",
                "sign_no": 5,
                "rashi_lord": "Sun",
                "nakshatra": "Purva Phalguni",
                "nakshatra_pada": 4,
                "nakshatra_no": 11,
                "nakshatra_lord": "Venus",
                "sub_lord": "Ketu",
                "sub_sub_lord": "Mercury",
                "house": 3
            },
            {
                "name": "Ascendant",
                "full_degree": "68.0729315",
                "speed": "325.2802250",
                "is_retro": "false",
                "is_combusted": "false",
                "longitude": "8:4:22",
                "sign": "Gemini",
                "sign_no": 3,
                "rashi_lord": "Mercury",
                "nakshatra": "Ardra",
                "nakshatra_pada": 1,
                "nakshatra_no": 6,
                "nakshatra_lord": "Rahu",
                "sub_lord": "Rahu",
                "sub_sub_lord": "Venus",
                "house": 1
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/kp/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"'

Node.js

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/kp/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/kp/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/kp/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)

Best Practices

Always include both Authorization and api_key in requests.

Ensure accurate birth time and coordinates for reliable KP readings.

KP system depends on precise sub-lord divisions — rounding values affects accuracy.

Use ISO-formatted timestamps when displaying results to end users.

For localization, pass lan to serve responses in user’s preferred language.

Secure your API credentials using environment variables or encrypted secrets.