---
title: "Lal Kitab Chart"
method: POST
path: "/v1/astro/lal-kitab/chart"
tags: ["Lal Kitab"]
---

# Lal Kitab Chart

`POST /v1/astro/lal-kitab/chart`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/lal-kitab/chart`
- Auth: HTTP bearer

Computes a Lal Kitab chart following the 1952 Lal Kitab: houses are counted from the Vedic lagna (whole sign) and the lagna house is read as house 1 (Aries). Returns the ascendant and all 9 planets with their Lal Kitab house, pakka ghar, uchcha (exalted) and neecha (debilitated) flags, fixed or doubtful effect and malefic indications, the 12 houses, and the 9 Lal Kitab debts (rin) with their remedies. Ayanamsa: lahiri (default), raman or kp; tropical is rejected because Lal Kitab starts from the sidereal Indian chart. Without a birth time a sunrise chart is used and birth_time_provided is false; houses are then approximate.

## Request body

- LalKitabRequest: Lal Kitab starts from the traditional Indian (sidereal) birth chart and names no ayanamsa, so any sidereal ayanamsa is honoured; tropical is not the chart the book starts from and is rejected.
  - `location` string, nullable: City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
  - `name` string: Person name associated with the birth record
  - `date` string, required: Birth date in YYYY-MM-DD format
  - `time` string, nullable: Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
  - `latitude` number, nullable: Latitude. Required if location not provided.
  - `longitude` number, nullable: Longitude. Required if location not provided.
  - `timezone` string, nullable: IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
  - `utc_offset` string, nullable: Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset `timezone` would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.
  - `ayanamsa` 'lahiri' | 'raman' | 'kp': Sidereal ayanamsa used to cast the birth chart: lahiri (default), raman or kp. Tropical is rejected: Lal Kitab starts from the sidereal Indian chart.

## Response `200`

Successful Response

- ApiResponseLalKitabChartResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` LalKitabChartResponse, required
    - `system` string, required
    - `ayanamsa` string, required
    - `birth_time_provided` boolean: False when no birth time was given: a sunrise chart is used, so the lagna and every house are approximate.
    - `ascendant` LalKitabAscendant, required
      - `longitude` number, required: Sidereal ascendant longitude in degrees, in the requested ayanamsa.
      - `rashi_index` integer, required: Ascendant sign, 0 = Aries. This house is Lal Kitab house 1.
      - `rashi` string, required
    - `planets` object, required
    - `houses` object, required
    - `rin_analysis` object, required
    - `sources` string[], required

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)