Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

KP Planets

The KP Planets API provides planetary positions and calculations based on the Krishnamurti Paddhati (KP) system of astrology. This endpoint is useful for KP horoscope analysis, prediction engines, and astrology applications.

https://json.astroinsightapi.com/api/v1/kp/planets
Credit Cost
1 Credit
Avg Latency
~47ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

API Overview & Calculation Details

Methodology and astrological context for KP Planets.

KP Planets

The KP Planets endpoint computes detailed planetary data for a given birth chart using the Krishnamurti Paddhati (KP) astrology system — a highly precise predictive astrology methodology developed by K.S. Krishnamurti. KP astrology is built upon the Placidus house system and the sub-lord theory, offering a more granular and accurate approach to astrological prediction compared to traditional systems.


What This API Does

This endpoint calculates the positions and KP-specific attributes of all major planets at the time of birth. It applies the KP methodology, which divides each zodiac sign into finer sub-divisions based on Nakshatras (lunar mansions/stars) and their sub-lords, enabling highly precise astrological analysis.

The calculation is driven by the Krishnamurti Ayanamsha — the sidereal offset used specifically in KP astrology — ensuring results are aligned with KP standards.


What Data It Returns

For each planet in the birth chart, the API returns:

  • Sign (Rashi) — The zodiac sign the planet occupies
  • Nakshatra (Star) — The lunar mansion the planet is positioned in
  • Sub-Lord — The sub-division lord within the Nakshatra, central to KP predictions
  • Sub-Sub-Lord — A further subdivision for even more precise analysis
  • House Position — The Placidus house the planet occupies
  • Retrograde Status — Whether the planet is in retrograde motion
  • KP Significators — The houses signified by each planet based on KP rules, used for event timing and prediction

Main Use Cases

  • KP Horoscope Analysis — Generate a complete KP birth chart with all planetary positions and their KP attributes for an individual
  • Event Timing & Prediction — Use sub-lord and significator data to time life events such as marriage, career changes, health events, and more
  • KP Astrology Platforms — Power KP-based astrology applications and services with accurate planetary computations
  • Astrological Research — Conduct research and comparative studies using KP planetary data across multiple charts

Request Parameters

Payload specifications for JSON request body.

application/json
Parameter Type Description & Example
day
Required
integer
Day of birth (1–31).
Example: 15
month
Required
integer
Month of birth (1–12).
Example: 9
year
Required
integer
Year of birth (e.g., 1994).
Example: 1994
hour
Required
integer
Hour of birth in 24-hour format (0–23).
Example: 12
min
Required
integer
Minute of birth (0–59).
Example: 30
sec
Optional
integer
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example: 30
lat
Required
float
Latitude of the birth location.
Example: 28.6139
lon
Required
float
Longitude of the birth location.
Example: 77.1025
tzone
Optional
float
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example: 5.5

Required & Optional Headers

Header Key Value / Format Description
Authorization
Required
Basic {base64} Base64 encoded string of CLIENT_ID:CLIENT_SECRET.
Content-Type
Required
application/json Specifies JSON payload format in request body.
Accept-Language
Optional
en, hi, ta, te... Returns localized astrology output. Default: en
X-Ayanamsha
Optional
lahiri, raman, krishnamurti... Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri

Frequently Asked Questions

Comprehensive developer guidance for KP Planets.

What is the KP Planets API and what data does it provide?

The KP Planets API provides authentic Krishnamurti Paddhati calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.

What input parameters are required to call KP Planets?

The KP Planets API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.

How many credits does the KP Planets endpoint consume?

Each calculation request to KP Planets consumes 1 API credit. The endpoint delivers high performance with an average response time of ~47ms.

How do I authenticate with the KP Planets API?

Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).

Can I get KP Planets responses in regional Indian languages?

Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.

Which Ayanamsha systems can be calculated with KP Planets?

Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.

What response format and HTTP codes does this API return?

The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.

POST kp/planets
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories