96Astro API

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-match and porutham.
  • 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.

On this page