Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Lal Kitab Houses

The Lal Kitab Houses API provides house-wise interpretations and calculations based on Lal Kitab astrology. It helps analyze different areas of life and their astrological influences.

https://json.astroinsightapi.com/api/v1/lalkitab/houses
Credit Cost
1 Credit
Avg Latency
~39ms
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 Houses.

The Lal Kitab Houses API returns a detailed, house-by-house analysis of a person's Lal Kitab birth chart, along with a rendered chart image. In Lal Kitab astrology, each of the 12 houses has a fixed sign association and carries specific life-area significance — from wealth and family to career, relationships, and spirituality. This endpoint computes the planetary occupancy and interpretive profile of each house from the birth data and delivers both the structured house data and a visual chart representation in a single response.

What This API Returns

Given a person's birth date, time, geographic coordinates, and visual configuration preferences, the API computes the Lal Kitab house analysis and returns:

  • House-by-house breakdown — a structured dataset for all 12 houses, each containing its fixed sign, the planets occupying it, and Lal Kitab-specific interpretive attributes for that house
  • Planetary occupancy — which planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) reside in each house, computed using Lal Kitab's fixed-sign house system
  • House significance and life-area mapping — interpretive context for each house based on Lal Kitab's framework, covering the domains of life governed by that house (e.g., self, wealth, siblings, home, children, health, relationships, longevity, fortune, career, income, expenditure)
  • Planetary influence on houses — details on how the occupying planets affect each house according to Lal Kitab rules, including benefic/malefic influence and any special conditions
  • Ascendant and chart orientation data — the Ascendant sign and the structural foundation of the chart as computed from the birth coordinates
  • Rendered chart image — a server-side generated visual birth chart diagram styled according to the visual configuration supplied in the request body
  • Ayanamsha-corrected calculations — all sidereal positions adjusted using the specified Ayanamsha for precise astronomical accuracy

Main Use Cases

  • House analysis features — powering dedicated "Houses" or "Bhava" sections in Lal Kitab astrology apps that explain the significance and planetary occupancy of each house in a user's chart
  • Life-area reading engines — feeding house data into prediction or interpretation modules that generate readings for specific life domains (career, relationships, finances, health, etc.) based on Lal Kitab house rules
  • Personalized horoscope reports — embedding the house-by-house analysis and rendered chart image into automated Lal Kitab reports or user profile pages
  • Remedy and ritual guidance — using house occupancy and planetary influence data to identify which houses need strengthening and what Lal Kitab remedies apply
  • Consultation and research tools — giving astrologers and researchers a structured, programmatic view of the house configuration for in-depth Lal Kitab analysis across individual charts or large datasets

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 Houses.

What is the Lal Kitab Houses API and what data does it provide?

The Lal Kitab Houses 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 Houses?

The Lal Kitab Houses 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 Houses endpoint consume?

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

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

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

API Categories