Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Lal Kitab Dharmi Horoscope

The Lal Kitab Dharmi Horoscope API provides Dharmi horoscope analysis based on Lal Kitab calculations, helping users understand karmic tendencies and spiritual influences.

https://json.astroinsightapi.com/api/v1/lalkitab/dharmi-horoscope
Credit Cost
1 Credit
Avg Latency
~58ms
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 Dharmi Horoscope.

The Lal Kitab Dharmi Horoscope API generates a Dharmic (religious/spiritual duty) horoscope reading based on the ancient Lal Kitab astrological system. Lal Kitab is a unique branch of Vedic astrology originating from Urdu texts, known for its unconventional interpretations of planetary positions and its emphasis on karmic debts, remedies, and life duties.

What This API Does

This endpoint accepts a person's birth details — including date, time, and geographic coordinates — and computes their Dharmi (duty-oriented) horoscope according to Lal Kitab principles. It interprets the planetary configuration at the time of birth to determine the individual's spiritual obligations, karmic responsibilities, and righteous path in life.

The Ayanamsha system used for sidereal calculations is configurable via the request header, allowing compatibility with different Vedic astrological traditions (e.g., Lahiri, Raman, KP).

What Data It Returns

The response provides a structured Lal Kitab Dharmi horoscope analysis, which typically includes:

  • Dharmic profile: An assessment of the individual's spiritual and moral duties based on their birth chart.
  • Planetary influences: Insights into how specific planets in the natal chart shape the person's Dharmic path.
  • Karmic indicators: Information about karmic debts or obligations derived from planetary placements in Lal Kitab houses.
  • Life duty guidance: Interpretations of the individual's righteous duties (Dharma) across different life areas such as family, career, and spirituality.

Results are returned in the language specified via the Accept-Language header, enabling multi-language support for diverse user bases.

Main Use Cases

  • Astrology platforms: Powering Lal Kitab-based horoscope features in astrology apps and websites.
  • Spiritual guidance tools: Providing users with personalised Dharmic insights to support self-reflection and spiritual growth.
  • Kundali/birth chart services: Enriching birth chart reports with Lal Kitab Dharmi analysis alongside traditional Vedic readings.
  • Multi-language astrology products: Delivering localised horoscope content to regional audiences in their native language.

Key Functionality

  • Lal Kitab system: Applies the distinctive Lal Kitab methodology for house and planet interpretation, which differs significantly from classical Vedic astrology.
  • Configurable Ayanamsha: Supports multiple Ayanamsha values for flexible sidereal zodiac calculations.
  • Geographic precision: Uses latitude, longitude, and timezone inputs to ensure accurate local sky calculations at the exact moment of birth.
  • Dharmic focus: Specifically oriented toward Dharma — the concept of righteous duty — rather than general predictive astrology, making it a specialised endpoint within the broader astrology API suite.
  • Localisation support: Returns interpretations in the requested language, making it suitable for global deployment.

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 Dharmi Horoscope.

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

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

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

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

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

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

API Categories