Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Lal Kitab Planet House Report

The Lal Kitab Planet House Report API generates a detailed report explaining the effects of a selected planet in a specific house according to Lal Kitab astrology principles.

https://json.astroinsightapi.com/api/v1/lalkitab/planet-house-report/:planetKey
Credit Cost
1 Credit
Avg Latency
~31ms
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 Lal Kitab Planet House Report.

Lal Kitab Planet House Report

The Lal Kitab Planet House Report API generates a detailed interpretive report for a specific planet based on its house placement in a Lal Kitab birth chart. Where the Lal Kitab Planets endpoint returns positional data for all nine planets, this endpoint goes a step further — it delivers the narrative, predictive, and remedial content associated with a single chosen planet occupying its particular house in the native's chart.

The planet to report on is specified as a path variable (planetKey), accepting any of the nine Vedic planets: sunmoonmarsmercuryjupitervenussaturnrahu, or ketu.

What This API Does

Given a person's birth details (date, time, and coordinates) and a target planet, this endpoint:

  • Calculates the house the specified planet occupies in the native's Lal Kitab chart using the sidereal zodiac and the Ayanamsha correction provided in the request header
  • Retrieves the full Lal Kitab interpretive report for that planet in that house — covering its effects on the native's life, relationships, finances, health, and karmic debts as defined by Lal Kitab tradition
  • Returns the report content in the language specified via the Accept-Language header

What Data It Returns

The response includes:

  • Planet identification — the planet being reported on and its computed house placement in the Lal Kitab chart
  • Interpretive report content — a structured Lal Kitab reading for the planet in its house, which may cover areas such as life effects, favourable and unfavourable periods, relationships with other planets in the chart, and the native's karmic obligations
  • Lal Kitab remedies — traditional remedial measures prescribed by Lal Kitab for the planet's house placement, such as charitable acts, rituals, or behavioural guidelines intended to mitigate malefic effects or strengthen benefic ones
  • House and sign context — supporting positional data that contextualises the report within the broader chart

Main Use Cases

  • Personalised planet reports — generating a dedicated, human-readable Lal Kitab reading for a single planet in a user's birth chart, suitable for display in astrology apps or PDF report generation
  • Remedy recommendation features — surfacing Lal Kitab-specific remedies for a planet based on its house, enabling remedy-focused product features without requiring the client to interpret raw positional data
  • Planet-by-planet horoscope builders — iterating over all nine planets to assemble a complete Lal Kitab horoscope report, one planet at a time, with each call returning a self-contained section
  • Targeted astrological insights — allowing users to query the report for a specific planet of interest (e.g. Saturn for career and discipline, Moon for emotional wellbeing) without fetching the full chart
  • Multi-language astrology platforms — serving planet house reports in the user's preferred language for localised astrology experiences

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 Lal Kitab Planet House Report.

What is the Lal Kitab Planet House Report API and what data does it provide?

The Lal Kitab Planet House Report API provides authentic Lal Kitab 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 Lal Kitab Planet House Report?

The Lal Kitab Planet House Report 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 Lal Kitab Planet House Report endpoint consume?

Each calculation request to Lal Kitab Planet House Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~31ms.

How do I authenticate with the Lal Kitab Planet House Report 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 Lal Kitab Planet House Report 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 Lal Kitab Planet House Report?

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

API Categories