✋ Palmistry API and 🎧 Audio Reports API are now live. Ship them in your app today.

Vedic Match Making APIs

With our Vedic matching APIs, you can cater to your pan India audience whether it is Ashtakoot for North Indian users or Dashkoota for South Indian users. Along with these, we also offer detailed interpretation API for each of the matching attributes and their remedies.

Ashtakoot Points

Check compatibility with eight major factors. The API provides detailed ashtakoot matching analysis.

image

Dashkoota Points

Compare the charts with the dashtakoota factors for compatibility matching. Along with ashtakoot points, the additional two factors are added for kundli matching .

image

Manglik Matching

With the manglik matching API, you can learn how a kundli matches under manglik dosha. It also calculates the percent of manglik match to predict if kundlis with manglik dosha are compatible.

image

Vedha and Rajju Dosha

Learn if kundli matching is affected by Vedha Dosha or Rajju Dosha as per compatibility analysis. The API identifies Vedha dosha and Rajju dosha in matching and suggests recommendations accordingly.

image

Get started with AstrologyAPI

Create a free account and test every endpoint with free credits. No credit card needed.

Match Making Report

Get an exculsive matching report with detailed calculations and remedies. The report delves into each compatibility factor from Vedic astrology to make better and more accurate predictions.

image

What the Kundli Matching API gives you

Kundli matching compares the birth charts of two people before marriage. Many families in India ask for it, and many matrimony sites show a score on each profile. Doing it yourself means two full charts and a long list of scoring rules.

Send us both sets of birth details in one request. We return the points for each factor, the total out of 36, and the dosha checks for the couple. You choose how much of it to show.

  • Ashtakoot points

    Eight factors, or koots, such as Varna, Yoni, Gan, Bhakut and Nadi. Each has its own points, and they add up to 36.

  • Dashakoot points

    Ten koots used in South India, including Dina, Rajju, Vedha, Mahendra and Stree Deergha.

  • Manglik check

    Manglik status for both people, with the rules that matched, the cancel rules and a percentage.

  • Rajju and Vedha dosha

    Two extra checks on the nakshatras (birth stars) of the couple. Each comes back as a clear true or false.

  • Papasamyam

    Dosha units from Sun, Mars, Saturn and Rahu, counted from the ascendant, Moon and Venus, with a final score.

  • Match report

    A short written conclusion and one match percentage that fits on a profile card.

Matching endpoints and sample responses

Every call is a POST that carries both birth records. Male fields start with m_ and female fields start with f_. Below are trimmed samples from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/match_ashtakoot_points

Ashtakoot (36 guna) score

Guna means point here. You get the points for each of the eight koots, the total, and the minimum_required value. A conclusion says if the match is favourable.

1{
2  "varna": {
3    "description": "Natural Refinement / Work",
4    "male_koot_attribute": "Kshatriya",
5    "female_koot_attribute": "Kshatriya",
6    "total_points": 1,
7    "received_points": 1
8  },
9  "nadi": {
10    "description": "Progeny / Excess",
11    "male_koot_attribute": "",
12    "female_koot_attribute": "",
13    "total_points": 8,
14    "received_points": 0
15  },
16  "total": {"total_points": 36, "received_points": 21, "minimum_required": 18},
17  "conclusion": {"status": true}
18}
Read the /match_ashtakoot_points reference →
POST/match_dashakoot_points

Dashakoot score

The ten koot version that many South Indian families use. Each koot shows the attribute for both people and the points received.

1{
2  "rajju": {
3    "description": "",
4    "male_koot_attribute": "-",
5    "female_koot_attribute": "-",
6    "total_points": 5,
7    "received_points": 5
8  },
9  "mahendra": {
10    "description": "",
11    "male_koot_attribute": "Hast",
12    "female_koot_attribute": "Krittika",
13    "total_points": 2,
14    "received_points": 0
15  },
16  "total": {"total_points": 36, "received_points": 19, "minimum_required": 18}
17}
Read the /match_dashakoot_points reference →
POST/match_making_report

Combined match report

One call that sums up the Ashtakoot points, the manglik percentages, and Rajju and Vedha dosha. It ends with a written conclusion.

1{
2  "ashtakoota": {"status": true, "received_points": 21},
3  "manglik": {
4    "status": true,
5    "male_percentage": 27.5,
6    "female_percentage": 28.25
7  },
8  "rajju_dosha": {"status": false},
9  "vedha_dosha": {"status": false},
10  "conclusion": {
11    "match_report": "Marriage between the prospective bride and groom is highly recommended. The couple would have a long-lasting relationship, which would be filled with happiness and affluence."
12  }
13}
Read the /match_making_report reference →
POST/match_percentage

One match percentage

Turns each check into a percentage and adds one overall match_percentage. The is_match_good flag gives you a simple yes or no.

1{
2  "ashtakoota_percentage": 58,
3  "manglik_match_percentage": 85,
4  "rajju_match_percentage": 100,
5  "vedha_match_percentage": 100,
6  "match_percentage": 79,
7  "is_match_good": true
8}
Read the /match_percentage reference →

Who uses kundli matching data

More than 3,000+ businesses build on AstrologyAPI. Here is where matching usually shows up.

Matrimony platforms

Show a guna score on each profile. Open the full koot table when a family wants more detail.

Kundli matching for matrimony platforms →

Dating apps

Add a Vedic match badge for users who care about it, next to your usual filters.

Astrology compatibility in a dating app →

Astrologer tools

Give the astrologer every koot, the manglik rules and the papasamyam score before the call starts.

Add kundli matching to your app →

Report sellers

Sell a printed match report that uses the same scores.

Kundli PDF API →

Kundli Matching API FAQ

What does the Kundli Matching API return?

We return Ashtakoot and Dashakoot scores, a manglik check for both people, and Rajju and Vedha dosha flags as JSON. You can also get a short written match report and one overall match percentage.

What is the difference between Ashtakoot and Dashakoot?

Both score a couple out of 36 points. Ashtakoot uses eight factors and is common in North India. Dashakoot uses ten factors and is common in South India. We return both, so you can show the one your users expect.

What do I send in a request?

Send the birth details of both people in one body. Fields for the male partner start with m_ and fields for the female partner start with f_. Each person needs day, month, year, hour, min, lat, lon and tzone.

How do you handle manglik dosha in a match?

Manglik dosha comes from the placement of Mars, and many families check it before a wedding. match_manglik_report checks each person and lists the rules that matched and the rules that cancel it. It also gives a percentage and a conclusion for the couple.

Which languages can the text come back in?

The main matching endpoints support English, Hindi, Marathi, Bengali, Tamil, Telugu, Malayalam and Kannada. papasamyam_details, match_obstructions and partner_report return English only.

How can I try it?

Sign up for a free account. You get an API key and 150 free credits, and you do not need a card. Try match_ashtakoot_points with two test birth records first.