API Documentation

Base URL: https://platform.astrohub.co.in/api/v1 · Auth header: X-API-Key: ah_live_… · Free tier: 30 req/min, 1000 req/day per key.

Use your ah_live_… key at this base URL or in the interactive API test console — both are metered against your quota. Any other host returns 401.

POST /api/v1/kundali

Vedic birth chart. `report` adds dashas/sade-sati + yearly & monthly predictions; `sampoorna` adds navamsa/chandra/chalit charts, doshas, Lal Kitab, ratna, naam karan, gochar + full faladesh.

{"name":"...", "date":"1990-05-15", "time":"10:30", "place":"Delhi",
 "answer_lang":"hindi", "interpret":"career", "report":true, "sampoorna":true}

POST /api/v1/panchang

Tithi, nakshatra, yoga, karana with end times; rahu kaal, muhurats. `explain` adds aaj-ka-panchang guidance.

{"date":"2026-07-11", "place":"Delhi", "explain":true, "answer_lang":"hindi"}

POST /api/v1/numerology

Mulank, bhagyank, life path, name numbers + traditional attributes (gemstone, mantra, direction…).

{"name":"Vinay Sikarwar", "date":"1990-05-15", "report":true, "answer_lang":"hindi"}

POST /api/v1/chat

Book-grounded astrology Q&A with source citations.

{"question":"What is Gajakesari yoga?", "answer_lang":"english"}

POST /api/v1/palm (multipart)

Palm photo analysis → observed features + reading grounded in palmistry classics.

image=@palm.jpg  question="career"  hindi=false

Errors & limits

  • 401 — missing/invalid API key
  • 429 — rate limit (per-minute) or daily quota exceeded; see Retry-After
  • 422 — invalid input (bad date, unknown place…)
  • Long operations (sampoorna report) can take 1–5 minutes — set client timeouts accordingly.

Readings are spiritual/entertainment guidance — not medical, legal or financial advice.