Home › Kundli matching API for matrimony platforms

Kundli matching API for matrimony platforms

36-guna ashtakoot, Mangal dosha with cancellation rules, and batch matching — as clean JSON.

Get a free API key Browse all 237 endpoints

What a matrimony product needs

36-guna matching — POST /v1/milan/ashtakoot returns all 8 koots with points, total/36, percentage and verdict (11 Milan endpoints)
Mangal dosha honesty — detection with classical cancellation rules, so profiles aren't wrongly labelled manglik
Batch screening — Batch Milan matches one profile against many in a single call, built for match-suggestion pipelines
Missing birth times — real profiles often lack exact times; responses carry an explicit accuracy flag instead of silently guessing
Hindi + English labels in every response — render either side of your bilingual UI without a second call

Integration sketch

POST /v1/milan/ashtakoot
{"person1": {"dob": "1990-06-15", "tob": "10:30", "lat": 28.6139, "lon": 77.209, "tz": 5.5},
 "person2": {"dob": "1992-11-22", "tob": "08:20", "lat": 26.85, "lon": 80.95, "tz": 5.5}}

→ {"total": 24, "max": 36, "percentage": 66.7, "verdict": "…", "nadi": {...}, ...}

Develop the whole flow on free unlimited sk-test- keys; the structure is guaranteed identical in production. Volume pricing is flat per call — matching bursts during festival seasons won't surprise-bill you, and paid plans are throttled, never blocked.

Frequently asked questions

Can it handle profiles without birth time?

Yes — tob is optional. The chart is computed from sunrise and the response includes an accuracy object marking which results are reliable. Matching still works; your UI can badge it as approximate.

How does batch matching price?

Batch Milan endpoints count one call per request like everything else — there is no credit multiplier. See the pricing page for per-plan volumes.

Is Mangal dosha detection fear-free?

It reports the dosha AND the classical cancellation (parihara) rules that apply, so a technically-manglik profile with cancellations is shown honestly — important for matrimony UX and fairness.