By topic / Kundli Matching API
Kundli Matching API: score one couple or a thousand candidates
Show one number on a profile card, explain it koota by koota on the detail page, and rank a whole list in a single call in place of hundreds. North and South Indian systems are both covered.
What people build with it
- Match scores on a matrimony site
- A ranked list of candidates
- A printed matching report
The endpoints
- One Match Score
One percentage for a couple that blends Ashtakoot with the Manglik, Rajju and Vedha checks, with each part and its weight.
POST /v1/matching/match-score
3 credits
- Ashtakoot Details
Koota-by-koota Ashtakoot breakdown for two birth stars, with each side's profile, the total, verdict and Nadi and Bhakoot doshas.
POST /v1/matching/ashtakoot-details
1 credit
- Dashakoot Match (Ashtakoot + Rajju + Vedha)
Ten-koota match from two birth stars: the eight Ashtakoot kootas plus Rajju and Vedha.
POST /v1/matching/south-match
1 credit
- Porutham (Tamil)
Tamil porutham check for two birth stars: each porutham with present, severity and a reading, and a summary band with objections.
POST /v1/matching/porutham
1 credit
- Kundli Matching (Ayu Milan)
Ashtakoot matching from two births: koota scores and total, Manglik for both with cancellations, Papasamya, Rajju and Vedha, and classical longevity (Ayurdaya) spans for each.
POST /v1/matching/ayu-milan
3 credits
- Match One to Many
One seeker's birth matched against up to 1000 candidates' births and ranked: north (Ashtakoot, Manglik, Vedha) and/or south (Dashakoot, Porutham, Rajju, Vedha) scores, doshas, filters and a ranked list.
POST /v1/matching/match-one-to-many
3 credits
- Rajju & Vedha Check
Rajju and Vedha for two birth stars: each side's cord and body part, same-cord and vedha flags with scores, and any objections.
POST /v1/matching/rajju-vedha
1 credit
- Kundli Matching Report
Matching report: each side's nakshatra, ascendant and Mangal dosha, Ashtakoot and Dashakoot scores, Rajju and Vedha with readings, koota vetoes, personality notes and a verdict.
POST /v1/reports/matching-report
10 credits
Common questions
- How is the blended score worked out?
- Ashtakoot counts 70%, and Manglik, Rajju and Vedha 10% each. The weights are ours, and each part comes back, so that you can apply your own.
- Can I match many people at once?
- Yes. match-one-to-many takes one seeker and up to 1,000 candidates in one call.

