Documentation
Add matchmaking to a matrimony site
Score a couple, explain the result, and rank many candidates against one seeker.
This guide covers the three calls a matrimony site usually needs.
One number for a profile card
match-score blends Ashtakoot with the Manglik, Rajju and Vedha checks into one percentage, and gives each part and its weight, so you can apply your own:
curl https://api.96astroapi.com/v1/matching/match-score \
-H "Authorization: Bearer $ASTRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"groom": { "datetime": "1990-10-18T14:30:00", "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209 },
"bride": { "datetime": "1992-03-05T09:15:00", "timezone": "Asia/Kolkata", "latitude": 19.076, "longitude": 72.8777 }
}'Ranking many candidates
Do not call this once per candidate. match-one-to-many takes one seeker and up to 1,000 candidates, and returns them ranked, with filters.
The full report
matching-report is the long reading for a paid profile. It can also be a branded PDF, in any of the report languages, or an audio report.
Good to know
- South Indian users expect Dashakoot and Porutham: use
south-matchandporutham. - A low score is not a verdict on two people. Show the reasons, and let them decide.
- Birth details are sensitive. Do not send them with a person's name unless a capability needs it, and see our data processing agreement.


