API documentation

Base URL

https://hsksem.online/api/v1

Authentication

During the open beta, endpoints are callable without a key. In production, send your key as a header:

x-api-key: YOUR_API_KEY

Response format

Success returns { "ok": true, "data": { ... } }. Errors return { "ok": false, "error": "message" } with a 4xx/5xx status.

Endpoints

GET /kundli

Birth chart: nakshatra, rasi, mangal dosha, yogas, dasha. Add svg=1 for the North-Indian chart.

datetime	ISO birth date-time, e.g. 1990-01-31T14:20:00+05:30 (bare time assumed IST). Required.
coordinates	lat,lng, e.g. 28.6139,77.2090. Required.
name	Optional label.

curl "https://hsksem.online/api/v1/kundli?datetime=1990-01-31T14:20:00%2B05:30&coordinates=28.6139,77.2090"

GET /match

Ashtakoota guna milan (36-point compatibility).

girl_dob, boy_dob	ISO date-time with time (IST if no offset). Required.
girl_coordinates, boy_coordinates	lat,lng. Required.

curl "https://hsksem.online/api/v1/match?girl_dob=1995-06-15T10:30:00%2B05:30&girl_coordinates=28.6139,77.2090&boy_dob=1993-03-22T14:00:00%2B05:30&boy_coordinates=19.0760,72.8777"

GET /panchang

Tithi, nakshatra, yoga, karana, vaara and sun/moon timings.

coordinates	lat,lng. Required.
date	Optional YYYY-MM-DD. Defaults to today.

curl "https://hsksem.online/api/v1/panchang?coordinates=28.6139,77.2090&date=2026-10-27"

GET /muhurat

Auspicious and inauspicious periods (Rahu kalam, Abhijit, Amrit kaal, Gulika, Yamaganda).

coordinates	lat,lng. Required.
date	Optional YYYY-MM-DD. Defaults to today.

curl "https://hsksem.online/api/v1/muhurat?coordinates=28.6139,77.2090"

GET /chart

Full chart facts: planets, houses, nakshatra, dasha tree and current transits. Same params as /kundli.

GET /health

Service status and endpoint list.