New Numerology API

Free tool

Free kundli matching (guna milan)

Kundli matching from API for Astrology (apiforastrology.com) scores two people out of 36 points, the traditional guna milan. Enter both people's birth dates, times and places to see the score for each of the eight factors. You also get the manglik (Mars) check for both charts and a one-word verdict with its reasons.

People also call it kundali milan or horoscope matching. We do not store the details you enter.

Updated

Bride's birth details

Not sure? It is often on the birth certificate.

Groom's birth details

Not sure? It is often on the birth certificate.

Sample, not your result: Jane Doe, Chicago, and John Doe, New York

© API for Astrology (apiforastrology.com). "Kundli matching explained". All rights reserved. Not to be copied or reused.Jane DoeChicagoMoon in ScorpioJohn DoeNew YorkMoon in Taurus8 checks compare the two Moons18 to pass22.5out of 36 pointsWorkableA match that can work, with a fewpoints to check with an astrologer

The two birth Moons are compared on eight factors for a score out of 36, with a plain verdict. Your own result shows under the form.

Kundli matching at a glance

What the kundli matching takes, gives back and costs
You sendTwo people's birth dates, times and places
You getThe guna milan score out of 36, the manglik check and a verdict
The API call behind itPOST /v1/matching on the Astrology API
What it costsFree on this page. In your app, 1 call per answer. The Free plan has 2,000 calls a month.

How kundli matching works

Guna milan looks only at the two birth Moons: their signs and their nakshatras (star groups). From these it scores eight factors, called kootas. They run from varna at 1 point up to nadi at 8, for 36 points in all. Eighteen points is the usual minimum families look for, but the total is not the whole story.

The verdict also weighs nadi and bhakoot, the two heaviest factors, and whether both people are manglik. Classical exceptions that cancel nadi or bhakoot dosha are applied and shown.

The traditional score is not symmetric. It names a bride and a groom, and swapping them can change the result, so the tool asks which is which. For pairs the tradition does not cover, there is no classical rule for who goes where.

The same request, with your own API key, returns the full result as JSON. That includes the ten southern matching checks (poruthams).

Worked example: Jane Doe and John Doe

Jane Doe, the bride, was born on March 22, 1992, in Chicago. John Doe, the groom, was born on August 15, 1990, in New York. Her Moon is in Scorpio, in Vishakha. His Moon is in Taurus, in Mrigashira.

Together they score 22.5 of 36 points, above the usual minimum of 18. Nadi and bhakoot are both clear. Both charts are manglik, which tradition treats as a balanced pair.

The verdict is workable, not favorable, because of one concern. One chart has noticeably more difficult planets in the marriage houses than the other. The result names that concern, so an astrologer can weigh it.

Method and sources

Planet positions come from NASA JPL planet data (DE440). We check them against NASA JPL Horizons. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising degree agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. See how we test. A practicing astrologer reviews the rules behind these answers.

Read next: Kundli matching for matrimony sites, Compatibility for dating apps.

Words used here, explained in the glossary: Ashtakoot (guna milan), Varna koota, Vashya koota, Tara koota, Yoni koota, Graha maitri, Gana koota, Bhakoot, Nadi koota, Manglik dosha, Rajju, Dashakoot.

We do not store the details you enter. Results are for information and entertainment, not advice.

Build this into your app

This tool runs on our Astrology API. Here is the request behind it and the answer, for our sample: Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York. Read about the kundli matching API.

POST /v1/matching

# Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/matching" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bride":{"year":1992,"month":3,"day":22,"hour":14,"minute":45,"second":0,"latitude":41.8781,"longitude":-87.6298,"timezone":"America/Chicago"},"groom":{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}}'
Answer (lists cut to two items)200 OK
{
  "bride": {
    "nakshatra": "Vishakha",
    "nakshatra_lord": "Jupiter",
    "moon_sign": "Scorpio"
  },
  "groom": {
    "nakshatra": "Mrigashira",
    "nakshatra_lord": "Mars",
    "moon_sign": "Taurus"
  },
  "kootas": {
    "varna": {
      "points": 0,
      "max": 1,
      "bride": "Brahmin",
      "groom": "Vaishya",
      "rule": "the groom's varna equals or exceeds the bride's",
      "text": [
        "The bride's Moon is in Scorpio and the groom's is in Taurus. That puts her in the Brahmin varna and him in the Vaishya. Varna is one of the eight kootas (checks) in the traditional 36-point match. It ranks each Moon sign by its element.…",
        "Don't give this much weight. Varna is worth one point out of 36, the lightest part of the whole system. And it is about formal rank, not about how two people actually live together. Matches are rarely turned down over varna. Look at nadi,…"
      ],
      "language": "en",
      "detail": "standard"
    },
    "vashya": {
      "points": 1,
      "max": 2,
      "bride": "Keeta",
      "groom": "Chatushpada",
      "rule": "from the vashya class of each Moon sign",
      "text": [
        "The bride's Scorpio is Keeta and the groom's Taurus is Chatushpada. Vashya is the koota (one of eight matching checks) that asks how easily each of you influences the other. It uses five groups of Moon signs. Your two groups work well…",
        "One of you influences the other more easily than the other way around. That is not a fault, and it is very common. One of you may give in more often. The other may need to notice that this is happening. A quick, honest word about it now…"
      ],
      "language": "en",
      "detail": "standard"
    },
    "tara": {
      "points": 1.5,
      "max": 3,
      "from_bride": {
        "count": 17,
        "remainder": 8,
        "auspicious": true
      },
      "from_groom": {
        "count": 12,
        "remainder": 3,
        "auspicious": false
      },
      "rule": "count between the nakshatras each way, mod 9; remainders 3, 5 and 7 are inauspicious",
      "text": [
        "Counting from Vishakha to Mrigashira leaves a remainder of 8, and counting back the other way leaves 3. Tara is the koota (matching check) that reads shared fortune. It counts between your two birth stars (nakshatras) in both directions.…",
        "Half is the normal result, the one most couples get. So read it as the middle, not as falling short. It also helps to know that **tara can never score zero**. The two counts always add up to 29, and no two bad remainders can do that. So…",
        "It shows a small imbalance in luck: one of you gains more visibly from being together than the other does. Over a long marriage, this is rarely something anyone notices."
      ],
      "language": "en",
      "detail": "standard"
    },
    "yoni": {
      "points": 2,
      "max": 4,
      "bride": "Tiger (M)",
      "groom": "Serpent (F)",
      "note": "neither the same nor sworn enemies",
      "rule": "same yoni scores full, sworn enemies score nothing",
      "text": [
        "The bride's yoni is Tiger (M) and the groom's is Serpent (F). The yoni koota (matching check) is a guide to physical and instinctive fit. It pairs an animal symbol with each birth star and compares the two. Yours are neither the same…",
        "Nothing here is bad at all. The koota simply has nothing strong to say about this pair. Half its points is what having nothing to say looks like. Read it as neutral, not as falling short, and put your attention on nadi, bhakoot and gana…"
      ],
      "language": "en",
      "detail": "standard"
    },
    "graha_maitri": {
      "points": 3,
      "max": 5,
      "bride_lord": "Mars",
      "groom_lord": "Venus",
      "bride_lord_sees_groom_lord_as": "neutral",
      "groom_lord_sees_bride_lord_as": "neutral",
      "rule": "natural friendship between the Moon-sign lords, read both ways",
      "text": [
        "The bride's Moon sign, Scorpio, is ruled by Mars, and the groom's Taurus by Venus. Graha maitri (planetary friendship) is the koota, or matching check, about how two minds meet. It reads this from the rulers of the Moon signs. Here the two…",
        "This koota gives a middle result here, and honestly it doesn't predict much. When your Moon lords are indifferent to each other, understanding is built the normal way: by living together and paying attention. Three out of five is neither a…"
      ],
      "language": "en",
      "detail": "standard"
    },
    "gana": {
      "points": 0,
      "max": 6,
      "bride": "Rakshasa",
      "groom": "Deva",
      "rule": "same gana scores full; the mismatch is graded by which side holds which",
      "text": [
        "The bride's Vishakha is Rakshasa and the groom's Mrigashira is Deva. Gana is the koota (matching check) that compares temperament, and here your temperaments pull in opposite directions. The tradition treats this direction most seriously,…",
        "All six points are lost. It's worth being honest about why this direction is marked harder than its mirror. The rule was written for a household where one partner was expected to give way. It penalizes the case where that partner is the…",
        "Gana has no cancellation. Losing six of 36 is a big loss, and it stands."
      ],
      "language": "en",
      "detail": "standard"
    },
    "bhakoot": {
      "points": 7,
      "max": 7,
      "distance": [
        7
      ],
      "dosha": false,
      "rule": "the 2-12, 5-9 and 6-8 axes carry bhakoot dosha and score nothing; every other distance scores full",
      "text": [
        "The bride's Moon is in Scorpio and the groom's in Taurus, 7 signs apart. Bhakoot is the koota (matching check) that reads this distance between your two Moon signs. Yours stays off the three difficult pairings (2 and 12, 5 and 9, 6 and 8).…",
        "Bhakoot is the second heaviest koota and the one most likely to fail, so passing it counts for a lot. This koota is read as being about the home itself: how well it does and how steady it is. It also shows whether you both move ahead in…"
      ],
      "language": "en",
      "detail": "standard"
    },
    "nadi": {
      "points": 8,
      "max": 8,
      "bride": "Antya",
      "groom": "Madhya",
      "dosha": false,
      "rule": "the same nadi on both sides scores nothing; different nadis score full",
      "text": [
        "Vishakha is in Antya nadi and Mrigashira in Madhya. Nadi is the koota (matching check) that sorts the birth stars into three groups linked with physical makeup. It only asks whether yours differ. They do, so this koota is passed.",
        "Nadi is worth eight points, the single biggest item in the scheme. The tradition reads it as a difference in physical makeup that bears on health and children. Families usually ask about it first.",
        "Passing it does a lot of work on its own. Eight of the 36 are secured. That gets a match almost halfway to the usual minimum before anything else is counted."
      ],
      "language": "en",
      "detail": "standard"
    }
  },
  "total": 22.5,
  "out_of": 36,
  "cancellations": [],
  "total_after_cancellation": 22.5,
  "band": {
    "band": "acceptable",
    "note": "the conventional minimum for a match is eighteen",
    "text": [
      "22.5 of 36, counting any points given back by the classical reliefs for nadi and bhakoot. Guna milan is the 36-point comparison of your two Moons. Most families are told to look for a minimum of 18, and this total clears it. But the total…",
      "No single koota is worth more than eight points. So a total in this range means points were lost in at least two places. **Which ones failed is what counts.** Nadi and bhakoot both have classical cancellations and may already have been…",
      "So read the eight entries above rather than the total. Two matches can both score 22 and be nothing alike. One has lost nadi and gana outright, two of the three heaviest kootas. The other has lost bhakoot and yoni, with smaller losses in…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "rajju": {
    "bride": "Nabhi",
    "groom": "Siro",
    "dosha": false,
    "signifies": null,
    "rule": "the same rajju on both sides is the dosha; different rajju is clear",
    "note": "not part of the thirty-six and carries no points. Read chiefly in the south.",
    "text": [
      "The bride's nakshatra is in the Nabhi rajju and the groom's in the Siro. Rajju is a check that sorts the 27 birth stars (nakshatras) onto five parts of the body. The dosha is when both of you fall on the same part. Yours are on different…",
      "It has no points and isn't part of the 36. Rajju is followed mostly in the south. It's shown here so a family that expects it knows it was checked."
    ],
    "language": "en",
    "detail": "standard"
  },
  "vedha": {
    "dosha": false,
    "bride": "Vishakha",
    "groom": "Mrigashira",
    "rule": "thirteen classical pairs obstruct each other; Chitra has no partner and is always clear",
    "note": "not part of the thirty-six and carries no points.",
    "text": [
      "Vishakha and Mrigashira are not a vedha pair, so nothing blocks them. Vedha (obstruction) is a separate check that lists 13 classical pairs of birth stars (nakshatras). These pairs are said to block each other directly, whatever else the…",
      "Vedha has no points and isn't part of the 36. So a clear result neither adds to your score nor takes from it. Abhijit and Chitra have no partner in this list, so they are always clear. Families who follow vedha are usually content once it…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "mangal": {
    "bride": {
      "present": true,
      "grade": "present",
      "by_reference": {
        "natal": {
          "present": true,
          "mars_house_from_reference": 7,
          "reference": "natal"
        },
        "lunar": {
          "present": true,
          "mars_house_from_reference": 4,
          "reference": "lunar"
        },
        "venus": {
          "present": true,
          "mars_house_from_reference": 1,
          "reference": "venus"
        }
      },
      "cancellations": [
        "Mars occupies a Saturn-ruled kendra",
        "Mars is the yogakaraka for this ascendant"
      ]
    },
    "groom": {
      "present": true,
      "grade": "present",
      "by_reference": {
        "natal": {
          "present": true,
          "mars_house_from_reference": 8,
          "reference": "natal"
        },
        "lunar": {
          "present": true,
          "mars_house_from_reference": 12,
          "reference": "lunar"
        },
        "venus": {
          "present": false,
          "mars_house_from_reference": 10,
          "reference": "venus"
        }
      },
      "cancellations": [
        "Mars is in its own sign"
      ]
    },
    "balance": "both",
    "matched": true,
    "verdict": "both charts are manglik from the ascendant or the Moon, which is held to neutralize",
    "rule": "Mars occupying house 1, 2, 4, 7, 8 or 12, counted separately from the ascendant, from the Moon and from Venus",
    "grading": "each side is graded from the ascendant and the Moon: present (found from either), partial (found only from Venus) or absent. Only present beside absent is a concern; present beside partial is noted as partly balanced",
    "note": "each chart's own manglik cancellations are reported but not applied -- weighing them is the astrologer's judgment, as in /v1/dosha/manglik",
    "text": [
      "Both the bride and the groom have manglik dosha by the main check, which counts from the ascendant (the sign rising at birth) and from the Moon. Manglik dosha is the concern raised when Mars sits in certain houses. Mars is the planet of…",
      "The classical rule here is clear, and it is the whole reason this comparison is made. **When both people are manglik, the dosha is taken to cancel out.** Manglik is about the force and temperament a person brings into a marriage. When both…",
      "So this is a better result than one of you having it alone. It gives no points either way and is not part of the 36. The eight kootas above are not affected by it."
    ],
    "language": "en",
    "detail": "standard"
  },
  "dashakoot": {
    "poruthams": {
      "dina": {
        "count": 17,
        "remainder": 8,
        "matched": true,
        "disputed": false,
        "rule": "count from the bride's nakshatra to the groom's, inclusive, and take the remainder on nine; 0, 2, 4, 6, 8 agree (zero being an exact division, parama mitra)",
        "note": null,
        "text": [
          "**Dina agrees.** Dina is a southern check (porutham) that counts from the bride's birth star to the groom's. Counting from Vishakha to Mrigashira, the star falls at 17, and the tradition reads the remainder as good.",
          "Dina is read for the couple's everyday well-being and good health. Dina is one of the five required poruthams, so its agreement removes a possible objection rather than adding a point. In plain terms, it is a small reassurance about daily…"
        ],
        "language": "en",
        "detail": "standard"
      },
      "gana": {
        "matched": false,
        "from_ashtakoot": "gana",
        "points_there": 0,
        "out_of_there": 6,
        "detail": {
          "points": 0,
          "max": 6,
          "bride": "Rakshasa",
          "groom": "Deva",
          "rule": "same gana scores full; the mismatch is graded by which side holds which"
        }
      },
      "mahendra": {
        "count": 17,
        "matched": false,
        "rule": "the same inclusive count agrees at 4, 7, 10, 13, 16, 19, 22, 25",
        "signifies": "progeny and the couple's shared prosperity",
        "text": [
          "**Mahendra does not agree**, at a count of 17. Mahendra is a southern check (porutham) read for children and shared wealth. Only eight of the 27 positions satisfy it, so failing here is common and not a warning.",
          "Mahendra is not one of the five required poruthams. Treat it as one check out of 10, not as a finding on its own."
        ],
        "language": "en",
        "detail": "standard"
      },
      "stree_deergha": {
        "count": 17,
        "by_threshold": {
          "above_9": true,
          "above_13": true
        },
        "sources_agree": true,
        "matched": true,
        "rule": "the groom's nakshatra should fall far enough ahead of the bride's, counted inclusively. Sources give the threshold as 9 and as 13",
        "signifies": "the bride's longevity and wellbeing",
        "note": null,
        "text": [
          "**Stree deergha agrees** at a count of 17. This southern check (porutham) counts forward from the bride's birth star to the groom's. Both thresholds in use accept this count, so there is no doubt here to report.",
          "Stree deergha is read for the bride's own long life and well-being. So it is counted from her star, not the groom's. That one-sidedness comes from the rule itself."
        ],
        "language": "en",
        "detail": "standard"
      },
      "yoni": {
        "matched": true,
        "from_ashtakoot": "yoni",
        "points_there": 2,
        "out_of_there": 4,
        "detail": {
          "points": 2,
          "max": 4,
          "bride": "Tiger (M)",
          "groom": "Serpent (F)",
          "note": "neither the same nor sworn enemies",
          "rule": "same yoni scores full, sworn enemies score nothing"
        }
      },
      "rasi": {
        "matched": true,
        "from_ashtakoot": "bhakoot",
        "points_there": 7,
        "out_of_there": 7,
        "detail": {
          "points": 7,
          "max": 7,
          "distance": [
            7
          ],
          "dosha": false,
          "rule": "the 2-12, 5-9 and 6-8 axes carry bhakoot dosha and score nothing; every other distance scores full"
        }
      },
      "rasyadhipathi": {
        "matched": true,
        "from_ashtakoot": "graha_maitri",
        "points_there": 3,
        "out_of_there": 5,
        "detail": {
          "points": 3,
          "max": 5,
          "bride_lord": "Mars",
          "groom_lord": "Venus",
          "bride_lord_sees_groom_lord_as": "neutral",
          "groom_lord_sees_bride_lord_as": "neutral",
          "rule": "natural friendship between the Moon-sign lords, read both ways"
        }
      },
      "vasya": {
        "matched": true,
        "from_ashtakoot": "vashya",
        "points_there": 1,
        "out_of_there": 2,
        "detail": {
          "points": 1,
          "max": 2,
          "bride": "Keeta",
          "groom": "Chatushpada",
          "rule": "from the vashya class of each Moon sign"
        }
      },
      "rajju": {
        "matched": true,
        "detail": {
          "bride": "Nabhi",
          "groom": "Siro",
          "dosha": false,
          "signifies": null,
          "rule": "the same rajju on both sides is the dosha; different rajju is clear",
          "note": "not part of the thirty-six and carries no points. Read chiefly in the south."
        }
      },
      "vedha": {
        "matched": true,
        "detail": {
          "dosha": false,
          "bride": "Vishakha",
          "groom": "Mrigashira",
          "rule": "thirteen classical pairs obstruct each other; Chitra has no partner and is always clear",
          "note": "not part of the thirty-six and carries no points."
        }
      }
    },
    "order": [
      "dina",
      "gana",
      "mahendra"
    ],
    "agreed": 8,
    "out_of": 10,
    "matched": [
      "dina",
      "stree_deergha",
      "yoni"
    ],
    "essential": [
      "dina",
      "gana",
      "yoni"
    ],
    "essential_failed": [
      "gana"
    ],
    "borrowed_from_ashtakoot": {
      "gana": "gana",
      "yoni": "yoni",
      "rasi": "bhakoot",
      "rasyadhipathi": "graha_maitri",
      "vasya": "vashya"
    },
    "rule": "ten poruthams, each read pass or fail. Five are held mandatory and a failure among those is not outweighed by the others",
    "not_scored": "these ten carry no points and are not a second thirty-six. Ashtakoot weights its eight one to eight; the tradition reads these yes or no and counts them",
    "note": "seven poruthams are the ashtakoot kootas asked a yes-or-no question and are read from those same results, so the two systems cannot disagree about one pair of Moons. Chiefly southern practice, where ashtakoot is chiefly northern",
    "text": [
      "**The 10 poruthams** are southern matching checks, each answered yes or no. They are the southern way of reading the same two Moons that the 36 points read. The tradition simply counts how many agree. This section has no second score, and…",
      "Seven of the 10 are the kootas you have already seen, asked a simpler question: not how many points, just whether it agrees. The other three (dina, mahendra and stree deergha) have no northern version. They are the reason to read this…",
      "**8 of the 10 agree** for the bride and the groom. Which ones agree matters more than the count, because five of the 10 are treated as required."
    ],
    "language": "en",
    "detail": "standard",
    "reading": {
      "text": [
        "**gana did not agree, and is among the five the southern texts treat as required.** Poruthams are the 10 yes-or-no checks of the southern method, and these five carry the most weight. That matters more than the total: a match that passes…",
        "A count cannot decide whether this ends the match. The list above does show exactly which rule objected and why. What objected is a rule of the southern school, not a verdict on two people. The northern reading of the same two Moons is the…"
      ],
      "language": "en",
      "detail": "standard"
    }
  },
  "papasamyam": {
    "bride": {
      "count": 8,
      "by_reference": {
        "natal": {
          "count": 2,
          "placements": [
            {
              "graha": "Sun",
              "house": 8,
              "reference": "natal"
            },
            {
              "graha": "Mars",
              "house": 7,
              "reference": "natal"
            }
          ]
        },
        "lunar": {
          "count": 3,
          "placements": [
            {
              "graha": "Mars",
              "house": 4,
              "reference": "lunar"
            },
            {
              "graha": "Rahu",
              "house": 2,
              "reference": "lunar"
            }
          ]
        },
        "venus": {
          "count": 3,
          "placements": [
            {
              "graha": "Sun",
              "house": 2,
              "reference": "venus"
            },
            {
              "graha": "Mars",
              "house": 1,
              "reference": "venus"
            }
          ]
        }
      },
      "placements": [
        {
          "graha": "Sun",
          "house": 8,
          "reference": "natal"
        },
        {
          "graha": "Mars",
          "house": 7,
          "reference": "natal"
        }
      ],
      "grahas_counted": [
        "Sun",
        "Mars",
        "Saturn"
      ],
      "houses": [
        1,
        2,
        4
      ],
      "references": [
        "natal",
        "lunar",
        "venus"
      ],
      "disputed": {
        "waning_moon": {
          "applies": true,
          "count": 2,
          "placements": [
            {
              "graha": "Moon",
              "house": 4,
              "reference": "natal"
            },
            {
              "graha": "Moon",
              "house": 1,
              "reference": "lunar"
            }
          ],
          "why_not_counted": "counted as a sixth papa graha by some traditions and not by others. Three references can move a total by three and change the verdict, so it is reported and not folded in"
        }
      },
      "rule": "a papa graha occupying house 1, 2, 4, 7, 8 or 12, counted separately from the ascendant, from the Moon and from Venus. Every placement counts one",
      "not_weighted": "several traditions weight the seventh and eighth more heavily and disagree on by how much, so this is a count. The placements are returned so a weighting can be applied outside"
    },
    "groom": {
      "count": 7,
      "by_reference": {
        "natal": {
          "count": 2,
          "placements": [
            {
              "graha": "Mars",
              "house": 8,
              "reference": "natal"
            },
            {
              "graha": "Saturn",
              "house": 4,
              "reference": "natal"
            }
          ]
        },
        "lunar": {
          "count": 2,
          "placements": [
            {
              "graha": "Mars",
              "house": 12,
              "reference": "lunar"
            },
            {
              "graha": "Saturn",
              "house": 8,
              "reference": "lunar"
            }
          ]
        },
        "venus": {
          "count": 3,
          "placements": [
            {
              "graha": "Sun",
              "house": 1,
              "reference": "venus"
            },
            {
              "graha": "Rahu",
              "house": 7,
              "reference": "venus"
            }
          ]
        }
      },
      "placements": [
        {
          "graha": "Mars",
          "house": 8,
          "reference": "natal"
        },
        {
          "graha": "Saturn",
          "house": 4,
          "reference": "natal"
        }
      ],
      "grahas_counted": [
        "Sun",
        "Mars",
        "Saturn"
      ],
      "houses": [
        1,
        2,
        4
      ],
      "references": [
        "natal",
        "lunar",
        "venus"
      ],
      "disputed": {
        "waning_moon": {
          "applies": true,
          "count": 1,
          "placements": [
            {
              "graha": "Moon",
              "house": 1,
              "reference": "lunar"
            }
          ],
          "why_not_counted": "counted as a sixth papa graha by some traditions and not by others. Three references can move a total by three and change the verdict, so it is reported and not folded in"
        }
      },
      "rule": "a papa graha occupying house 1, 2, 4, 7, 8 or 12, counted separately from the ascendant, from the Moon and from Venus. Every placement counts one",
      "not_weighted": "several traditions weight the seventh and eighth more heavily and disagree on by how much, so this is a count. The placements are returned so a weighting can be applied outside"
    },
    "bride_count": 8,
    "groom_count": 7,
    "excess_on_bride": 1,
    "balanced": false,
    "verdict": "the bride carries 1 more papa placement than the groom, which is the imbalance this rule exists to catch",
    "rule": "the groom's papa count should equal or exceed the bride's; a bride carrying markedly more is the concern",
    "no_tolerance_applied": "traditions that allow a gap disagree about its width, so the gap is reported rather than judged against an invented threshold",
    "note": "a count, never a score, and never folded into the thirty-six. The mangal comparison reads Mars alone from the same three references and is reported separately",
    "text": [
      "**Papa samyam** (the balance of difficult planets) asks a different question from everything above. The 36 points and the 10 poruthams read two Moons. This reads two whole charts, and it counts strain rather than compatibility.",
      "Papa samyam is the manglik rule made wider. Manglik looks at whether Mars sits in the six sensitive houses (the 1st, 2nd, 4th, 7th, 8th and 12th). These are counted from the ascendant, from the Moon and from Venus. Papa samyam asks the…",
      "**A high count does not mean a bad chart.** What the rule looks for is an imbalance between the two of you, and only in one direction."
    ],
    "language": "en",
    "detail": "standard",
    "reading": {
      "text": [
        "**The bride has 1 more papa placements than the groom**, 8 against 7. Papa placements are the difficult planets (the Sun, Mars, Saturn, Rahu and Ketu) sitting in sensitive houses. The rule is meant to catch this imbalance, and it is shown…",
        "But it is not a number to act on by itself. Traditions that allow some gap disagree on how big a gap is acceptable, so no cut-off is applied here. You get the difference and the placements behind it, and the judgment is left to you and…",
        "Weigh it against the manglik comparison next to this. Manglik looks at Mars alone, in the same six houses and from the same three references. If both point the same way, the concern is real. If only this one does, it is coming from planets…"
      ],
      "language": "en",
      "detail": "standard"
    }
  },
  "cross_affliction": {
    "bride_seventh_lord": {
      "host": "bride",
      "visitor": "groom",
      "seventh_lord": "Saturn",
      "seventh_lord_sign": "Capricorn",
      "debilitated": false,
      "conjunct_visitor_mars": false,
      "sign": null,
      "afflicted": false
    },
    "groom_seventh_lord": {
      "host": "groom",
      "visitor": "bride",
      "seventh_lord": "Jupiter",
      "seventh_lord_sign": "Cancer",
      "debilitated": false,
      "conjunct_visitor_mars": false,
      "sign": null,
      "afflicted": false
    },
    "afflicted": false,
    "afflicted_directions": [],
    "provenance": "INVENTION",
    "rule": "each person's own 7th house ruler (7th lord) is checked: is it debilitated (in its weakest sign), and does the other person's Mars sit in the same sign? No orb is used. It is checked both ways, because the two directions read different…",
    "basis": "the 36 ashtakoot points read only the two Moons and cannot see this. This check reads both whole charts",
    "not_classical": "no classical text checks the 7th house ruler against the other person's Mars this way. It is the API's own check, built from two results it already has, not a classical rule"
  },
  "note": "the thirty-six points read the two Moons and nothing else. Rajju, vedha and the mangal comparison are reported beside the score and carry no points.",
  "dasha_sandhi": {
    "as_of": "2026-10-01T00:00:00",
    "bride": {
      "mahadasha": "Mercury",
      "antardasha": "Jupiter",
      "mahadasha_ends": "2030-03-27T02:08:27.875401",
      "antardasha_ends": "2027-07-17T22:59:27.875401",
      "in_sandhi": false,
      "which": null
    },
    "groom": {
      "mahadasha": "Jupiter",
      "antardasha": "Moon",
      "mahadasha_ends": "2030-12-20T19:27:09.380502",
      "antardasha_ends": "2027-08-21T07:27:09.380502",
      "in_sandhi": false,
      "which": null
    },
    "in_sandhi": [],
    "clear": true,
    "rule": "the sandhi is the first or last antardasha of a mahadasha",
    "note": "the width of the seam is not stated by the texts. This is the definition the API uses, and it scales with the mahadasha rather than being a fixed number of months.",
    "text": [
      "Neither of you is at a dasha sandhi. A sandhi is the point where one mahadasha (a major planetary period, lasting years) ends and the next begins.",
      "That changeover is seen as an unsettled time in life. A marriage that starts inside one is traditionally said to have a shaky start. Neither of you is there, so this check raises no concern about timing.",
      "Like every timing check, it carries no points and sits outside the 36. It depends on the date being asked about, not on either birth chart alone."
    ],
    "language": "en",
    "detail": "standard"
  },
  "conclusion": {
    "verdict": "workable",
    "serious": [],
    "concerns": [
      {
        "check": "papa",
        "text": "One chart carries noticeably more difficult planetary weight in the marriage houses than the other. An astrologer can tell you whether the gap matters in your case."
      }
    ],
    "strengths": [
      {
        "check": "score_ok",
        "text": "The points pass the usual minimum: 22.5 out of 36."
      },
      {
        "check": "nadi_clear",
        "text": "Nadi, the check most families care about most, is clear."
      }
    ],
    "noted": [
      {
        "check": "dashakoot",
        "text": "In the southern 10-check system, these mandatory checks do not agree: gana. This happens in most pairs, so it is noted here and not counted in the verdict."
      }
    ],
    "not_checked": [],
    "total": 22.5,
    "out_of": 36,
    "essential_failed": [
      "gana"
    ],
    "rule": "any serious finding makes it difficult; otherwise any concern makes it workable, after an astrologer looks at the concerns; otherwise favorable. Serious: under 18 points after the reliefs, nadi or bhakoot dosha with no relief, or a…",
    "headline": "This match can work. The main checks pass, with 22.5 out of 36 points. But a few things need a closer look before you decide. They are listed below.",
    "next": [
      "Show the points listed above to your astrologer, with both full charts.",
      "Ask whether each chart's own exceptions settle them.",
      "Decide after that talk, not on the points alone."
    ],
    "note": "This sums up the classical checks. A marriage rests on much more than a chart, so this is not a final word. Use it with an astrologer's reading and your own judgment.",
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "fell_back_to_en": false,
  "meta": {
    "bride": {
      "ayanamsa": "lahiri",
      "ayanamsa_value": 23.748455,
      "julian_day": 2448704.365261,
      "ephemeris": "JPL DE440s",
      "node": "true",
      "timezone": {
        "source": "zone",
        "offset_hours": -6,
        "zone": "America/Chicago",
        "abbreviation": "CST",
        "dst": false,
        "dst_hours": 0,
        "ambiguous_resolved_by_fold": null,
        "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
      }
    },
    "groom": {
      "ayanamsa": "lahiri",
      "ayanamsa_value": 23.7260727,
      "julian_day": 2448119.10483,
      "ephemeris": "JPL DE440s",
      "node": "true",
      "timezone": {
        "source": "zone",
        "offset_hours": -4,
        "zone": "America/New_York",
        "abbreviation": "EDT",
        "dst": true,
        "dst_hours": 1,
        "ambiguous_resolved_by_fold": null,
        "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
      }
    }
  }
}

Free tools

More free tools

Each one runs on our APIs. Enter your details and see the answer in your browser.

  • Free kundli

    Your Vedic birth chart: the rising sign and all nine planets, with sign, house and nakshatra.

    Make my kundli
  • Today's panchang

    Tithi (lunar day), nakshatra, sunrise, rahu kaal and the choghadiya (good and bad parts of the day) for your own city.

    See today's panchang
  • Manglik dosha check

    Whether Mars makes a chart manglik, counted three ways, with any exceptions.

    Check for manglik dosha
  • Sade sati check

    Whether sade sati, Saturn's 7.5-year pass around your Moon sign, is running for you, which phase, and the dates.

    Check my sade sati
  • Nakshatra finder

    Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.

    Find my nakshatra
  • Numerology calculator

    Your mulank, bhagyank and name number from a name and a birth date.

    Find my numbers
  • Life path number calculator

    Your life path number with master numbers kept, plus your expression, soul urge and personality numbers.

    Find my life path
  • Name numerology calculator

    A name's Chaldean and Pythagorean numbers, with other spellings compared against your birth date.

    Check my name
  • Lo Shu grid calculator

    The Lo Shu grid from a birth date, with missing and repeated numbers and full and empty lines.

    Draw my Lo Shu grid

From the blog

Common questions

All questions
What does the guna score out of 36 mean?

It is the total of eight traditional checks on the two Moons. The tool shows the points for each, so you can see where the total came from. Most families treat 18 as the pass mark. A higher score is a good sign in tradition, but it is read together with the doshas, and it is not a promise.

What guna milan is
How is the verdict decided?

It follows a fixed rule, not a hidden score. Fewer than 18 points, or a nadi or bhakoot dosha that no exception cancels, makes a match difficult. Otherwise any concern, such as only one person being manglik, makes it workable. A match with neither is favorable.

Read the verdict rule
Why does the kundli matching tool ask who is the bride and who is the groom?

The traditional score is not the same both ways. A few factors, such as varna and gana, compare one side against the other, so swapping the two people can change the total. The tool follows the classical method, which names a bride and a groom.

Why the score is not symmetric
What if one or both of us is manglik?

Two manglik charts are traditionally treated as a balanced pair, so that is no concern. The pairing tradition flags is one manglik chart with one that is not, and the tool lists that as worth a closer look. To see how Mars falls in one chart, use the manglik dosha calculator.

Check one chart for manglik dosha
What are rajju and vedha in kundli matching?

They are two South Indian checks on the birth stars, and neither is part of the 36 points. Rajju groups the 27 nakshatras by parts of the body, and both Moons in the same group is a rajju dosha. Vedha names pairs of nakshatras that block each other. If either is found, the verdict lists it as a concern. For Jane Doe and John Doe, both are clear.

What rajju dosha is
What if we do not know a birth time?

This tool needs a time for both people. The guna score uses only the two Moons, so a time that is off by an hour rarely changes it. The manglik check counts from the rising sign, though, and that needs an accurate time.

Can I add kundli matching to my own app?

Yes. The POST /v1/matching request, sent with your own API key, returns the full result as JSON, including the ten southern checks (poruthams). When only the two nakshatras and padas are known, POST /v1/matching/nakshatra gives the score without birth charts.

About the matching API

Astrology API

Put this in your own app

Create a free test key and call the same endpoint with your users' details. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer