Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

KP House Significator

The KP House Significator API identifies house significators according to Krishnamurti Paddhati astrology. This endpoint helps astrologers evaluate the influence of houses and improve predictive analysis.

https://json.astroinsightapi.com/api/v1/kp/house-significator
Credit Cost
1 Credit
Avg Latency
~45ms
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 House Significator.

KP House Significator

The KP House Significator endpoint is a core analytical tool within the Krishnamurti Paddhati (KP) astrology system. It computes the complete significator matrix for all 12 houses of a birth chart — the foundational data structure upon which all KP-based predictions and event timing are built.


What This API Does

Given a person's birth details (date, time, and geographic coordinates), this endpoint calculates which planets are significators of each of the 12 astrological houses, and conversely, which houses each planet signifies. The computation follows the classical KP rules of significatorship:

  • Occupant: A planet physically placed in a house directly signifies that house.
  • Owner (Sign Lord): The planet that rules the zodiac sign on the cusp of a house signifies that house.
  • Star Lord of Occupant: A planet whose nakshatra (star) is occupied by a planet placed in a house signifies that house.
  • Star Lord of Owner: A planet whose nakshatra is occupied by the house lord also becomes a significator of that house.

Each significator is returned along with its level or type of significatorship, making it possible to rank and prioritize planets for prediction purposes.


What Data It Returns

  • House-wise significator lists: For each of the 12 houses, a list of planets that signify it, along with the nature/level of their connection (occupant, owner, star lord link, etc.).
  • Planet-wise house lists: A reverse mapping showing, for each planet, the set of houses it signifies — essential for Dasha lord analysis.

Main Use Cases

  • KP Event Prediction: Determine whether a life event tied to a specific house (e.g., marriage → 7th house, career → 10th house) is promised in the chart.
  • Dasha-Based Timing Analysis: Cross-reference the current Dasha and Antardasha lords against house significators to time events with precision.
  • House Promise Evaluation: Assess the strength and relevance of a house by examining the quality and quantity of its significators.
  • Professional KP Astrologer Tools: Power desktop or web-based KP software used by practicing astrologers.
  • Automated Prediction Engines: Build rule-based or AI-assisted KP prediction systems that require structured significator data.
  • KP Astrology Platforms: Serve as the backbone data layer for any platform offering KP chart analysis, consultations, or reports.

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 House Significator.

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

The KP House Significator 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 House Significator?

The KP House Significator 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 House Significator endpoint consume?

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

How do I authenticate with the KP House Significator 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 House Significator 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 House Significator?

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/house-significator
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories