POST/v1/astro/lal-kitab/chart

Lal Kitab Chart

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 parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

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_offsetoptional

string | null

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.

ayanamsaoptional

string

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 fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.system

string

data.ayanamsa

string

data.birth_time_provided

boolean

False when no birth time was given: a sunrise chart is used, so the lagna and every house are approximate.

data.ascendant

object

data.ascendant.longitude

number

Sidereal ascendant longitude in degrees, in the requested ayanamsa.

data.ascendant.rashi_index

integer

Ascendant sign, 0 = Aries. This house is Lal Kitab house 1.

data.ascendant.rashi

string

data.planets

object

data.houses

object

data.rin_analysis

object

data.sources

array[string]

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Lal Kitab Remedies

Request

POST·application/json

curl
Python
TypeScript

curl -X POST "https://api.asterwise.com/v1/astro/lal-kitab/chart" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

import asterwise
from asterwise.api.lal_kitab_api import LalKitabApi
from asterwise.models.lal_kitab_request import LalKitabRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = LalKitabRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = LalKitabApi(client)
    result = api.lal_kitab_chart(lal_kitab_request=request)
    print(result)

import { createClient, createConfig, lalKitabChart } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await lalKitabChart({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "system": "lal_kitab",
    "ayanamsa": "lahiri",
    "birth_time_provided": true,
    "ascendant": {
      "longitude": 205.3029,
      "rashi_index": 6,
      "rashi": "Tula"
    },
    "planets": {
      "Sun": {
        "longitude": 205.9405,
        "rashi_index": 6,
        "rashi": "Tula",
        "lk_house": 1,
        "house_lord": "Mars",
        "is_retrograde": false,
        "pucca_ghar": true,
        "pucca_houses": [
          1
        ],
        "uchcha": true,
        "neecha": false,
        "uchcha_houses": [
          1
        ],
        "neecha_houses": [
          7
        ],
        "effect": "fixed",
        "companion_planets": [],
        "malefic_reasons": []
      },
      "Moon": {
        "longitude": 198.1821,
        "rashi_index": 6,
        "rashi": "Tula",
        "lk_house": 1,
        "house_lord": "Mars",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          4
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          2
        ],
        "neecha_houses": [
          8
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Saturn"
        ],
        "malefic_reasons": []
      },
      "Mars": {
        "longitude": 165.9962,
        "rashi_index": 5,
        "rashi": "Kanya",
        "lk_house": 12,
        "house_lord": "Jupiter",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          3,
          8
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          10
        ],
        "neecha_houses": [
          4
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Jupiter",
          "Venus",
          "... and 1 more item"
        ],
        "malefic_reasons": []
      },
      "Mercury": {
        "longitude": 228.5229,
        "rashi_index": 7,
        "rashi": "Vrischika",
        "lk_house": 2,
        "house_lord": "Venus",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          7
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          6
        ],
        "neecha_houses": [
          12
        ],
        "effect": "doubtful",
        "companion_planets": [],
        "malefic_reasons": []
      },
      "Jupiter": {
        "longitude": 285.9597,
        "rashi_index": 9,
        "rashi": "Makara",
        "lk_house": 4,
        "house_lord": "Moon",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          2,
          5,
          "... and 2 more items"
        ],
        "uchcha": true,
        "neecha": false,
        "uchcha_houses": [
          4
        ],
        "neecha_houses": [
          10
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Mars"
        ],
        "malefic_reasons": []
      },
      "Venus": {
        "longitude": 189.3758,
        "rashi_index": 6,
        "rashi": "Tula",
        "lk_house": 1,
        "house_lord": "Mars",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          7
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          12
        ],
        "neecha_houses": [
          6
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Mars",
          "Saturn"
        ],
        "malefic_reasons": [
          "house 1 is the pakka ghar of its enemy Sun"
        ]
      },
      "Saturn": {
        "longitude": 215.7471,
        "rashi_index": 7,
        "rashi": "Vrischika",
        "lk_house": 2,
        "house_lord": "Venus",
        "is_retrograde": false,
        "pucca_ghar": false,
        "pucca_houses": [
          8,
          10
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          7
        ],
        "neecha_houses": [
          1
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Moon",
          "Venus"
        ],
        "malefic_reasons": []
      },
      "Rahu": {
        "longitude": 14.809,
        "rashi_index": 0,
        "rashi": "Mesha",
        "lk_house": 7,
        "house_lord": "Venus",
        "is_retrograde": true,
        "pucca_ghar": false,
        "pucca_houses": [
          12
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          3,
          6
        ],
        "neecha_houses": [
          9,
          12
        ],
        "effect": "doubtful",
        "companion_planets": [],
        "malefic_reasons": [
          "house 7 is owned by its enemy Venus",
          "house 7 is the pakka ghar of its enemy Venus"
        ]
      },
      "Ketu": {
        "longitude": 194.809,
        "rashi_index": 6,
        "rashi": "Tula",
        "lk_house": 1,
        "house_lord": "Mars",
        "is_retrograde": true,
        "pucca_ghar": false,
        "pucca_houses": [
          6
        ],
        "uchcha": false,
        "neecha": false,
        "uchcha_houses": [
          9,
          12
        ],
        "neecha_houses": [
          3,
          6
        ],
        "effect": "doubtful",
        "companion_planets": [
          "Mars"
        ],
        "malefic_reasons": [
          "house 1 is owned by its enemy Mars"
        ]
      }
    },
    "houses": {
      "1": {
        "house": 1,
        "rashi_index": 0,
        "rashi": "Mesha",
        "lord": "Mars",
        "birth_rashi_index": 6,
        "birth_rashi": "Tula",
        "pucca_ghar_of": [
          "Sun"
        ],
        "occupants": [
          "Sun",
          "Moon",
          "... and 2 more items"
        ],
        "signification": "Royal throne (the ascendant)"
      },
      "2": {
        "house": 2,
        "rashi_index": 1,
        "rashi": "Vrishabha",
        "lord": "Venus",
        "birth_rashi_index": 7,
        "birth_rashi": "Vrischika",
        "pucca_ghar_of": [
          "Jupiter"
        ],
        "occupants": [
          "Mercury",
          "Saturn"
        ],
        "signification": "Place of worship, life span, old age"
      },
      "3": {
        "house": 3,
        "rashi_index": 2,
        "rashi": "Mithuna",
        "lord": "Mercury",
        "birth_rashi_index": 8,
        "birth_rashi": "Dhanu",
        "pucca_ghar_of": [
          "Mars"
        ],
        "occupants": [],
        "signification": "Manner of leaving this world: illness and the like"
      },
      "4": {
        "house": 4,
        "rashi_index": 3,
        "rashi": "Karka",
        "lord": "Moon",
        "birth_rashi_index": 9,
        "birth_rashi": "Makara",
        "pucca_ghar_of": [
          "Moon"
        ],
        "occupants": [
          "Jupiter"
        ],
        "signification": "Mother's lap"
      },
      "5": {
        "house": 5,
        "rashi_index": 4,
        "rashi": "Simha",
        "lord": "Sun",
        "birth_rashi_index": 10,
        "birth_rashi": "Kumbha",
        "pucca_ghar_of": [
          "Jupiter"
        ],
        "occupants": [],
        "signification": "Children and the future"
      },
      "6": {
        "house": 6,
        "rashi_index": 5,
        "rashi": "Kanya",
        "lord": "Mercury",
        "birth_rashi_index": 11,
        "birth_rashi": "Meena",
        "pucca_ghar_of": [
          "Ketu"
        ],
        "occupants": [],
        "signification": "Underworld; treasure of mercy, secret help"
      },
      "7": {
        "house": 7,
        "rashi_index": 6,
        "rashi": "Tula",
        "lord": "Venus",
        "birth_rashi_index": 0,
        "birth_rashi": "Mesha",
        "pucca_ghar_of": [
          "Mercury",
          "Venus"
        ],
        "occupants": [
          "Rahu"
        ],
        "signification": "Household life, the grind of daily living"
      },
      "8": {
        "house": 8,
        "rashi_index": 7,
        "rashi": "Vrischika",
        "lord": "Mars",
        "birth_rashi_index": 1,
        "birth_rashi": "Vrishabha",
        "pucca_ghar_of": [
          "Mars",
          "Saturn"
        ],
        "occupants": [],
        "signification": "Mortality and justice"
      },
      "9": {
        "house": 9,
        "rashi_index": 8,
        "rashi": "Dhanu",
        "lord": "Jupiter",
        "birth_rashi_index": 2,
        "birth_rashi": "Mithuna",
        "pucca_ghar_of": [
          "Jupiter"
        ],
        "occupants": [],
        "signification": "Start of luck"
      },
      "10": {
        "house": 10,
        "rashi_index": 9,
        "rashi": "Makara",
        "lord": "Saturn",
        "birth_rashi_index": 3,
        "birth_rashi": "Karka",
        "pucca_ghar_of": [
          "Saturn"
        ],
        "occupants": [],
        "signification": "Field on which luck is founded"
      },
      "11": {
        "house": 11,
        "rashi_index": 10,
        "rashi": "Kumbha",
        "lord": "Saturn",
        "birth_rashi_index": 4,
        "birth_rashi": "Simha",
        "pucca_ghar_of": [
          "Jupiter"
        ],
        "occupants": [],
        "signification": "Seat of the guru, place of justice"
      },
      "12": {
        "house": 12,
        "rashi_index": 11,
        "rashi": "Meena",
        "lord": "Jupiter",
        "birth_rashi_index": 5,
        "birth_rashi": "Kanya",
        "pucca_ghar_of": [
          "Rahu"
        ],
        "occupants": [
          "Mars"
        ],
        "signification": "Place of rest and dreams"
      }
    },
    "sources": [
      "Lal Kitab tradition"
    ],
    "rin_analysis": {
      "pitru_rin": true,
      "swayam_rin": false,
      "matru_rin": false,
      "stri_rin": true,
      "rishtedar_rin": true,
      "behan_rin": false,
      "zalimana_rin": false,
      "ajanma_rin": true,
      "dev_rin": false,
      "active_rins": [
        "pitru_rin",
        "stri_rin",
        "... and 2 more items"
      ],
      "rin_remedies": [
        {
          "rin": "pitru_rin",
          "name": "Debt to father / ancestors (Pitri rin)",
          "planet": "Jupiter",
          "houses": [
            2,
            5,
            "... and 2 more items"
          ],
          "found": [
            {
              "planet": "Mercury",
              "house": 2
            }
          ],
          "remedy": "Collect one rupee from every blood relative and give it at a temple on one day; revere a peepal tree or shrine within 16…",
          "source": "Lal Kitab tradition"
        },
        {
          "rin": "stri_rin",
          "name": "Debt to wife / women (Stri rin)",
          "planet": "Venus",
          "houses": [
            2,
            7
          ],
          "found": [
            {
              "planet": "Rahu",
              "house": 7
            }
          ],
          "remedy": "Feed 100 healthy cows in one day, paid for jointly and equally by the whole family.",
          "source": "Lal Kitab tradition"
        },
        "... and 2 more items"
      ],
      "rule": "A debt is indicated when one of its enemy planets sits in the houses of the debt's planet (Lal Kitab debt table). Rahu a…",
      "not_evaluated": "The 1952 text adds two checks that are not computed here: the 'first degree' form (Mercury in the planet's houses while…",
      "remedy_rules": "Do one remedy at a time, for 40 or 43 days (weeks when the whole family takes part), and never two at once. Debts are re…"
    }
  }
}

Request parameters​

Response fields​

Errors​

Related endpoints​

Request parameters

Response fields

Errors

Related endpoints