Kundli matching API demo

One real call to POST /v1/match/ashtakoot (1 credit): two births in, the Ashtakoot (Guna Milan) score out of 36 with each of the eight kootas. The body below holds two sample births; edit them and press Send.

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON){ "person_a": { "date": "1990-08-13", "time": "06:30", "place": { "latitude": 28.6139, "longitude": 77.209 } }, "person_b": { "date": "1992-03-02", "time": "14:10", "place": { "latitude": 19.076, "longitude": 72.8777 } } }

Send

What comes back

• total and max: the points scored out of 36.
• kootas: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi, each with its score, its maximum and a short note.
• conclusion: a one-line summary of the score band, meant as a default you can replace with your own wording.

A matrimony or matching app usually shows the total first and the kootas below it. Manglik matching, Dashakoot and Papasamyam are separate calls in the matchmaking reference, so you pay only for what you show.

The same call in code

curl -X POST 'https://api.astrologics.in/v1/match/ashtakoot' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"person_a":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"person_b":{"date":"1992-03-02","time":"14:10","place":{"latitude":19.076,"longitude":72.8777}}}'

import json
import urllib.error
import urllib.request

body = {
    "person_a": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "person_b": {
        "date": "1992-03-02",
        "time": "14:10",
        "place": {
            "latitude": 19.076,
            "longitude": 72.8777,
        },
    },
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/match/ashtakoot",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

const res = await fetch("https://api.astrologics.in/v1/match/ashtakoot", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "person_a": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "person_b": {
      "date": "1992-03-02",
      "time": "14:10",
      "place": {
        "latitude": 19.076,
        "longitude": 72.8777
      }
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Questions

Where do the scoring rules come from?

Each koota is scored from its table, and the note says what it compared. The sources for the Vashya, Graha Maitri, Gana and Tara rules are on conventions, so your app can explain a score.

Can I match more than two people at once?

Each call compares one pair. To rank many profiles, call it once per pair and cache the results: a pair's score never changes.

Is there a PDF match report?

Yes: POST /v1/reports/match.pdf (10 credits) returns a branded PDF.

Looking to match your own kundli rather than build an app? Use the free kundli matching on astrologics.in.