Skip to content
96Astro API
Get API Key

Compatibility matching

Available

Match One to Many API

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
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/matching/match-one-to-many \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "seeker": {
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "seeker_side": "groom",
      "candidates": [
        {
          "id": "c-101",
          "datetime": "1992-03-02T05:47:00",
          "timezone": "Asia/Kolkata",
          "latitude": 19.0767,
          "longitude": 72.8767
        },
        {
          "id": "c-102",
          "datetime": "1994-07-21T22:10:00",
          "timezone": "Asia/Kolkata",
          "latitude": 12.9716,
          "longitude": 77.5946
        }
      ],
      "system": "both"
    }'

Overview

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.

Call it with POST /v1/matching/match-one-to-many. Input: specific input. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/matching/match-one-to-many
  • 3 credits
  • Specific input

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataMeasured from 3 real answers to different inputs: a required field was in every one.

  • systemstring
  • detailstring
  • seekerobject
  • filtersobject
  • rankingstring
  • countsobject
  • rankedarray of object
  • seeker_sidestring
  • resultsarray of object
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.

Loading the example…

Request schema and every field: the Compatibility matching reference.

Related endpoints

FAQ

Match One to Many API: common questions

4answers

Ask the team
01What does the Match One to Many API return?

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. The response's data object includes system, detail, seeker, filters, ranking, counts, ranked and seeker_side. See the reference for an example response.

02What input does Match One to Many need?

Specific input.

03How much does a Match One to Many call cost?

3 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.