← Lal Kitab engine/Lal Kitab
POST/v1/lal-kitab/horoscope

Lal Kitab · Horoscope API

Fixed-house kundli with awake/asleep planet states.

Get free API keyTry in playgroundFull schema in docs

About the engine

Part of the Lal Kitab engine

The Lal Kitab engine implements Joshi 1941: a fixed Aries=H1 frame, awake/asleep planetary states, blind-house markers, the seven ancestral debts (rin), and the remedy catalog. Includes a tradition disclaimer because the system is heuristic and prescriptive.

Request

Try it from the command line

curl -X POST 'https://api.astronode.dev/v1/lal-kitab/horoscope' \
  -H 'Authorization: Bearer aie_test_REPLACE_WITH_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "date": "1993-07-04",
  "time": "09:27:11",
  "tz_offset_minutes": 330,
  "lat": 31.7473,
  "lng": 77.7754
}'

Paste and run - this is the exact payload our live playground sends to this endpoint, so it is valid against the current schema. Every AstroNode endpoint needs a bearer token from your dashboard. Test keys (aie_test_*) work on the free tier - 1,000 requests / month, no card.

Request schema

Fields POST /v1/lal-kitab/horoscope accepts

Request body fields for POST /v1/lal-kitab/horoscope
FieldTypeNotes
daterequiredstring

pattern ^\d{4}-\d{2}-\d{2}$

e.g. 1993-07-04

timerequiredstring

pattern ^\d{2}:\d{2}(:\d{2})?$

e.g. 09:27:11

tz_offset_minutesrequiredinteger

Offset from UTC in minutes (e.g., 330 for IST)

-840..840

e.g. 330

latrequirednumber

-90..90

e.g. 31.7473

lngrequirednumber

-180..180

e.g. 77.7754

Generated from the same OpenAPI 3.1 document the API validates against, so this table cannot drift from the endpoint without the build failing.

Response

What you get back

Every AstroNode response uses the same envelope: request_id, data (the endpoint-specific payload), interpretation (optional narrative block), and meta (engine version + computed_at timestamp). This endpoint documents 200, 400, 401, 429.

The data payload for POST /v1/lal-kitab/horoscope is not yet broken out field by field in the published schema. The fastest way to see its exact shape is to run the call - the playground returns a live response with no signup, and the API reference carries the full document.

Engine highlights

What the Lal Kitab engine ships

  • Joshi 1941 fixed-house kundli (Aries always H1)
  • Awake/asleep planet classification per the canonical table
  • Blind-house markers (8th + 12th)
  • Seven rins (ancestral debts) - Pitri, Matra, Bhratra, Stree, Putra, Sansar, Atman
  • Remedy catalog tied to the chart's debts and weak planets

Related endpoints

Other Lal Kitab endpoints

POST/v1/lal-kitab/planets

Planet states (asleep / awake, friendly / inimical) in LK convention.

POST/v1/lal-kitab/houses

House-by-house occupancy + emptiness markers.

POST/v1/lal-kitab/debts

Seven rins (ancestral debts) detected with intensity.

POST/v1/lal-kitab/remedies

Planet-specific Lal Kitab remedies - pass `planet` to scope to one.

Ready to call POST /v1/lal-kitab/horoscope?

Free tier covers 1,000 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

Informational, not predictive. Not medical, legal, or financial advice.