← Remedies engine/Remedies
POST/v1/lal-kitab/remedies

Lal Kitab · Remedies API

Planet-specific Lal Kitab remedies (separate tradition catalog).

Get free API keyTry in playgroundFull schema in docs

About the engine

Part of the Remedies engine

Three composers (gemstone, rudraksha, puja) that derive recommendations from the birth chart's lagna lord, active doshas, current mahadasha, and afflicted planets. Catalogs are paraphrased from named traditional sources (Brihat Parashara Hora Shastra, Padma Purana, Garuda Purana). Every entry ships with review_status='pending_astrologer_pass' and a mandatory cultural-not-clinical disclaimer baked into the response envelope.

Request

Try it from the command line

curl -X POST 'https://api.astronode.dev/v1/lal-kitab/remedies' \
  -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,
  "planet": "Saturn"
}'

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/remedies accepts

Request body fields for POST /v1/lal-kitab/remedies
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

planetenum

Sun | Moon | Mars | Mercury | Jupiter | Venus | Saturn | Rahu

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/remedies 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 Remedies engine ships

  • 27 gemstones - 9 planets × primary, secondary, tertiary ranks (BPHS ch. 70; Garuda Purana)
  • 14 rudrakshas - 1-mukhi through 14-mukhi (Padma Purana; Shiva Purana)
  • 30 pujas - navagraha shantis, dosha-shantis, deity rites, yajnas (BPHS; Mantra-mahodadhi)
  • Recommendations driven by lagna lord, active doshas, current mahadasha, and afflicted planets
  • Every entry source-cited; review_status='pending_astrologer_pass' is part of the wire shape
  • Pure-function composers: same chart facts in → identical recommendation out (deterministic)

Related endpoints

Other Remedies endpoints

POST/v1/remedies/gemstone

Primary stone for the lagna lord + alternates + per-affliction stones.

POST/v1/remedies/rudraksha

Primary mukhi for the lagna lord + per-affliction mukhis. Full 14-mukhi catalog.

POST/v1/remedies/puja

Pujas ranked by active doshas → mahadasha → lagna lord → afflicted planets, plus a temple guide: temples across India, next good days and yatras.

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

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.