Kundli matching API reference
Updated
The kundli matching endpoints of API for Astrology (apiforastrology.com) compare two people's birth details for marriage. You get the 36-point ashtakoot (guna milan) score, factor by factor. Another endpoint scores a pair from their birth stars alone, with no birth times. Couple forecasts cover love, career and wealth. The group has 4 endpoints.
Call POST /v1/matching with both people's birth details. Jane Doe and John Doe score 22.5 of 36. The conclusion block gives a verdict and a headline you can show as they are. The 36 points of guna milan explains each koota (factor) behind the score. If the two people know only their birth stars, use POST /v1/matching/nakshatra. Both charts must use the same ayanamsa, or the call gets a 422 error.
Compatibility between two people, as used for marriage matching in India. The main result is the 36-point ashtakoot score, built from eight factors called kootas. The response also shows the standard exceptions that cancel a zero score on a factor, and checks that are reported outside the score. A forecast for a couple is here too. The score is not symmetric, so requests name the two people bride and groom.
4 endpoints. Paths are relative to https://apiforastrology.com/api/astrology. Send your API key in the Authorization: Bearer header (see authentication). No key yet? Get a key. To send test requests from the browser, open the interactive reference.
Overview: Kundli matching.
Which matching endpoint to call
| What you need | Endpoint | Cost |
|---|---|---|
| The 36-point score for two people with birth details. Start here | POST /v1/matching | 1 call |
| A score from the two birth stars alone, with no birth times | POST /v1/matching/nakshatra | 1 call |
| Each person's planets placed in the other's houses | POST /v1/matching/parasparam | 1 call |
| A love, career or wealth forecast for a couple | POST /v1/forecast/couple/{theme} | 6 reading credits |
Marriage compatibility score (ashtakoot, 36 points)
POST /v1/matching
Returns the ashtakoot compatibility score for two people, out of 36 points, factor by factor, with readings. Ashtakoot (also called guna milan) is the traditional Vedic marriage-matching score. It has eight factors called kootas, worth 1 to 8 points each. Each result lists the conditions that qualify it.
The score uses only the two Moons: each person's Moon nakshatra (lunar mansion) and Moon sign. Nothing else in either chart affects it. Keep that in mind before treating the number as a verdict on two people.
Standard exceptions are applied, and shown. Two factors, nadi and bhakoot, are worth 15 points together, and each scores all or nothing. A zero on either can drop a couple below the usual pass mark of 18. The texts that describe these problems (doshas) also give exceptions that cancel them. total is the raw score and total_after_cancellation is the score with the exceptions applied. Both are returned, so you can ignore an exception you do not accept.
Rajju, vedha and the Mars (mangal) comparison carry no points. They are reported next to the score, not added to it. When both people are manglik, tradition holds that the two cancel out; the case tradition warns about is one manglik person and one who is not. Each person in mangal has a grade: present (found counting from the ascendant or the Moon, the main check), partial (found only from Venus, a milder sign) or absent. mangal.balance names the pairing. Only present beside absent (one_sided) is a concern; present beside partial is noted in the conclusion, not counted.
The response also has dashakoot, ten pass-or-fail checks (poruthams) used in South India. It also has papasamyam, which compares the two people's malefic planet counts (see /v1/dosha/papa).
Pass as_of with a proposed wedding date to add the dasha sandhi check. Dasha sandhi is the junction between two main planetary periods (mahadashas), traditionally avoided for weddings. Here it means the first or last sub-period of a main period. The check says whether either person is in one on that date.
The request names the two people bride and groom because the score is not symmetric: swapping them can change it.
The tables are in rulebook section KM (the API's rule reference), marked as school choices where the classical texts differ.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| bride | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
| groom | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
Optional inputs (3), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
| as_of | query | A proposed wedding date, YYYY-MM-DD. Adds the dasha sandhi check for both people. |
Main response fields
bride(object): holds nakshatra, nakshatra_lord, moon_sign.groom(object): holds nakshatra, nakshatra_lord, moon_sign.kootas(object): holds varna, vashya, tara, yoni, graha_maitri, gana, bhakoot, nadi.total(number)out_of(number)cancellations(array)total_after_cancellation(number)band(object): holds band, note, text, language, detail.rajju(object): holds bride, groom, dosha, signifies, rule, note, text, language, detail.vedha(object): holds dosha, bride, groom, rule, note, text, language, detail.mangal(object): holds bride, groom, balance, matched, verdict, rule, grading, note, text, language, detail.dashakoot(object): holds poruthams, order, agreed, out_of, matched, essential, essential_failed, borrowed_from_ashtakoot, rule, not_scored, note, text.papasamyam(object): holds bride, groom, bride_count, groom_count, excess_on_bride, balanced, verdict, rule, no_tolerance_applied, note, text, language.cross_affliction(object): holds bride_seventh_lord, groom_seventh_lord, afflicted, afflicted_directions, provenance, rule, basis, not_classical.note(string)dasha_sandhi(object): holds as_of, bride, groom, in_sandhi, clear, rule, note, text, language, detail.conclusion(object): holds verdict, serious, concerns, strengths, noted, not_checked, total, out_of, essential_failed, rule, headline, next.gaps(array)language(string)detail(string)fell_back_to_en(boolean)meta(object): holds bride, groom.
# 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?as_of=2026-10-01" \
-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"}}'{
"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"
},
{
"graha": "Ketu",
"house": 8,
"reference": "lunar"
}
]
},
"venus": {
"count": 3,
"placements": [
{
"graha": "Sun",
"house": 2,
"reference": "venus"
},
{
"graha": "Mars",
"house": 1,
"reference": "venus"
},
{
"graha": "Saturn",
"house": 12,
"reference": "venus"
}
]
}
},
"placements": [
{
"graha": "Sun",
"house": 8,
"reference": "natal"
},
{
"graha": "Mars",
"house": 7,
"reference": "natal"
},
{
"graha": "Mars",
"house": 4,
"reference": "lunar"
}
],
"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"
},
{
"graha": "Ketu",
"house": 1,
"reference": "venus"
}
]
}
},
"placements": [
{
"graha": "Mars",
"house": 8,
"reference": "natal"
},
{
"graha": "Saturn",
"house": 4,
"reference": "natal"
},
{
"graha": "Mars",
"house": 12,
"reference": "lunar"
}
],
"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."
},
{
"check": "bhakoot_clear",
"text": "Bhakoot, the Moon-sign check, 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"
}
}
}
}Example from a real call for Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Kundli matching. Free tool: Kundli matching.
Compatibility score from two nakshatras, no birth charts
POST /v1/matching/nakshatra
Returns the 36-point ashtakoot score, its standard exceptions, rajju, vedha and the ten poruthams (South Indian pass-or-fail checks). It uses only each person's Moon nakshatra (lunar mansion) and pada (quarter of a nakshatra). Use it when the two people know their nakshatras but not their birth times.
The score is the same as with full charts. Every scoring factor uses only the two Moons, so this runs the same calculation as /v1/matching. The same pair of nakshatras scores the same on both endpoints.
What needs full charts is listed in not_computed: the Mars (mangal) comparison and papa samyam need Mars and the other malefic planets; reading the two whole charts against each other needs both charts; and the dasha sandhi check needs the birth dates.
The pada is required because it fixes the Moon's sign, which the bhakoot, varna, vashya and graha maitri factors use.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| bride | body | A Moon position given as a nakshatra and pada, with no birth time needed. A nakshatra is one of 27 lunar mansions, and a pada is one of its four quarters. |
| groom | body | A Moon position given as a nakshatra and pada, with no birth time needed. A nakshatra is one of 27 lunar mansions, and a pada is one of its four quarters. |
Optional inputs (2), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
Main response fields
bride(object): holds nakshatra, nakshatra_lord, moon_sign, pada.groom(object): holds nakshatra, nakshatra_lord, moon_sign, pada.kootas(object): holds varna, vashya, tara, yoni, graha_maitri, gana, bhakoot, nadi.total(number)out_of(number)cancellations(array of objects): each item holds koota, granted, reason.total_after_cancellation(number)band(object): holds band, note, text, language, detail.rajju(object): holds bride, groom, dosha, signifies, rule, note, text, language, detail.vedha(object): holds dosha, bride, groom, rule, note, text, language, detail.dashakoot(object): holds poruthams, order, agreed, out_of, matched, essential, essential_failed, borrowed_from_ashtakoot, rule, not_scored, note, text.note(string)conclusion(object): holds verdict, serious, concerns, strengths, noted, not_checked, total, out_of, essential_failed, rule, headline, next.gaps(array)language(string)detail(string)fell_back_to_en(boolean)not_computed(array of strings)
curl -X POST "https://apiforastrology.com/api/astrology/v1/matching/nakshatra" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"bride":{"nakshatra":"Mrigashira","pada":1},"groom":{"nakshatra":"Mrigashira","pada":1}}'{
"bride": {
"nakshatra": "Mrigashira",
"nakshatra_lord": "Mars",
"moon_sign": "Taurus",
"pada": 1
},
"groom": {
"nakshatra": "Mrigashira",
"nakshatra_lord": "Mars",
"moon_sign": "Taurus",
"pada": 1
},
"kootas": {
"varna": {
"points": 1,
"max": 1,
"bride": "Vaishya",
"groom": "Vaishya",
"rule": "the groom's varna equals or exceeds the bride's",
"text": [
"The bride's Moon is in Taurus and the groom's is in Taurus. That puts him in the Vaishya varna and her in the Vaishya. Varna (a rank read from the element of each Moon sign) is the first of the eight kootas. The kootas are the checks that…",
"Varna is the lightest check in the whole system, so it is worth saying plainly. It looks at formal rank, not at affection, temperament or health. When it is met, all it tells you is that nothing is objected to. The other seven kootas say…"
],
"language": "en",
"detail": "standard"
},
"vashya": {
"points": 2,
"max": 2,
"bride": "Chatushpada",
"groom": "Chatushpada",
"rule": "from the vashya class of each Moon sign",
"text": [
"Taurus belongs to the Chatushpada group and Taurus to the Chatushpada. Vashya is one of the eight kootas (checks) in the traditional match. It sorts Moon signs into groups to see how readily one partner is led by the other. Both of you are…",
"In plain terms, neither of you has to struggle to be heard, and neither has to be handled. You mostly see it in small things, not big ones. Disagreements tend to settle fast. Neither of you usually has to raise your voice to be taken…"
],
"language": "en",
"detail": "standard"
},
"tara": {
"points": 3,
"max": 3,
"from_bride": {
"count": 1,
"remainder": 1,
"auspicious": true
},
"from_groom": {
"count": 1,
"remainder": 1,
"auspicious": true
},
"rule": "count between the nakshatras each way, mod 9; remainders 3, 5 and 7 are inauspicious",
"text": [
"Counting from Mrigashira to Mrigashira leaves a remainder of 1, and counting back the other way leaves 1. Tara is the koota (matching check) that counts the distance between your two birth stars in a cycle of nine. Birth stars (nakshatras)…",
"Tara is about shared good luck: the idea that each of you does better with the other around than you would alone. Of the eight kootas, it is the one most about fortune rather than character. No other koota measures the same thing twice,…"
],
"language": "en",
"detail": "standard"
},
"yoni": {
"points": 3,
"max": 4,
"bride": "Serpent (F)",
"groom": "Serpent (F)",
"note": "the same yoni and the same sex, which is held to be slightly less favorable",
"rule": "same yoni scores full, sworn enemies score nothing",
"text": [
"The bride's Mrigashira gives the Serpent (F) yoni and the groom's Mrigashira gives the Serpent (F). This koota (matching check) compares the animal symbol, or yoni, of each birth star. The comparison is a guide to physical and instinctive…",
"The tradition sees this as slightly less easy than a male and female pair. The idea is that being alike without balancing each other can turn into sameness. One point is held back for that. In practice this is a strong result and the…"
],
"language": "en",
"detail": "standard"
},
"graha_maitri": {
"points": 5,
"max": 5,
"bride_lord": "Venus",
"groom_lord": "Venus",
"bride_lord_sees_groom_lord_as": "friend",
"groom_lord_sees_bride_lord_as": "friend",
"rule": "natural friendship between the Moon-sign lords, read both ways",
"text": [
"Taurus is ruled by Venus and Taurus by Venus. The two are natural friends both ways, or the same planet rules both signs. Graha maitri (planetary friendship) is the koota, or matching check, that compares the ruling planets of your two…",
"Graha maitri is about how well your minds and feelings agree, and at five points it really moves the total. It describes two people who follow each other's thinking without needing it explained. Over the years, that matters more than most…",
"It has a second job too. A full graha maitri is one of the classical reliefs that cancels bhakoot dosha. That is the fault raised when the two Moon signs sit at a difficult distance. If bhakoot failed, look at this score again, because it…"
],
"language": "en",
"detail": "standard"
},
"gana": {
"points": 6,
"max": 6,
"bride": "Deva",
"groom": "Deva",
"rule": "same gana scores full; the mismatch is graded by which side holds which",
"text": [
"Mrigashira and Mrigashira, your two birth stars (nakshatras), both belong to the Deva gana. So the two of you face the world in the same way. Gana is the koota (matching check) about temperament, and sharing one gives its full six points.",
"Temperament here means the pace and force with which you move through an ordinary day. When it matches, it is a good sign for everyday married life rather than for anything dramatic. You get fewer arguments that aren't about the topic at…"
],
"language": "en",
"detail": "standard"
},
"bhakoot": {
"points": 7,
"max": 7,
"distance": [
1
],
"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 Taurus and the groom's in Taurus, 1 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": 0,
"max": 8,
"bride": "Madhya",
"groom": "Madhya",
"dosha": true,
"rule": "the same nadi on both sides scores nothing; different nadis score full",
"text": [
"Mrigashira and Mrigashira are both in Madhya nadi. Nadi is the koota (matching check) that groups the birth stars by physical makeup. The same nadi on both sides is exactly what it is there to catch.",
"All eight points are lost, the biggest single loss in guna milan (the 36-point match). Classical practice reads a shared nadi as too much sameness in physical makeup, which it links with health and children. Of the eight kootas, this is…",
"It can also be cancelled, and the cancellations are not obscure. They are: both Moons in the same sign, two different nakshatras with the same ruling planet, or the same nakshatra falling in different signs. Check the cancellations listed…"
],
"language": "en",
"detail": "standard"
}
},
"total": 27,
"out_of": 36,
"cancellations": [
{
"koota": "nadi",
"granted": true,
"reason": "both Moons are in the same sign"
}
],
"total_after_cancellation": 35,
"band": {
"band": "excellent",
"note": "well above what is usually asked for",
"text": [
"35.0 of 36, counting any points given back by the classical reliefs for nadi and bhakoot. This total comes from guna milan, the traditional check that adds up eight kootas comparing your two Moons. The score is well above anything families…",
"It tells you how well two Moons agree: temperament, instinct, physical makeup and the luck each brings to the other. It can't say whether you treat each other kindly, or whether both families behave well. A high score can't make either of…",
"Read the individual kootas anyway. Even a total this high can hide a zero in something that matters to you. The number families remember is rarely the one that turns out to matter."
],
"language": "en",
"detail": "standard"
},
"rajju": {
"bride": "Siro",
"groom": "Siro",
"dosha": true,
"signifies": "the gravest of the five; danger to the husband",
"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": [
"Both nakshatras are in the Siro rajju, the head. Rajju sorts the birth stars (nakshatras) onto five parts of the body. The dosha is when both of yours land on the same part. The tradition calls the head the most serious of the five and…",
"It's stated plainly because hiding it would leave a family unable to tell it was checked. But two things go with it. It has no points and doesn't affect the 36. And it is a regional practice, followed in the south and mostly not in the…",
"Where it is followed, the classical answer is a remedy for this part, not turning the match down."
],
"language": "en",
"detail": "standard"
},
"vedha": {
"dosha": false,
"bride": "Mrigashira",
"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": [
"Mrigashira 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"
},
"dashakoot": {
"poruthams": {
"dina": {
"count": 1,
"remainder": 1,
"matched": false,
"disputed": true,
"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": "remainder one is janma, the bride's own star -- refused by some and allowed by others when the pada differs. Reported as disputed rather than placed on one side",
"text": [
"**Dina does not agree.** Dina is the southern check (porutham) that counts from the bride's birth star to the groom's and reads the remainder. Counting from Mrigashira to Mrigashira, the star falls at 1. The remainder after dividing by…",
"Dina is one of the five required poruthams, so this is a real objection, not a small detail. Read it as the southern school's own reservation about this pair of stars, which it links with everyday well-being. It says nothing about anything…"
],
"language": "en",
"detail": "standard"
},
"gana": {
"matched": true,
"from_ashtakoot": "gana",
"points_there": 6,
"out_of_there": 6,
"detail": {
"points": 6,
"max": 6,
"bride": "Deva",
"groom": "Deva",
"rule": "same gana scores full; the mismatch is graded by which side holds which"
}
},
"mahendra": {
"count": 1,
"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 1. 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": 1,
"by_threshold": {
"above_9": false,
"above_13": false
},
"sources_agree": true,
"matched": false,
"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 does not agree** at a count of 1. This southern check (porutham) counts forward from the bride's birth star to the groom's. Both thresholds in use reject this count, so the sources are not divided here.",
"Stree deergha is read for the bride's long life and well-being. Because it is not one of the five required poruthams, it does not rule the match out on its own."
],
"language": "en",
"detail": "standard"
},
"yoni": {
"matched": true,
"from_ashtakoot": "yoni",
"points_there": 3,
"out_of_there": 4,
"detail": {
"points": 3,
"max": 4,
"bride": "Serpent (F)",
"groom": "Serpent (F)",
"note": "the same yoni and the same sex, which is held to be slightly less favorable",
"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": [
1
],
"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": 5,
"out_of_there": 5,
"detail": {
"points": 5,
"max": 5,
"bride_lord": "Venus",
"groom_lord": "Venus",
"bride_lord_sees_groom_lord_as": "friend",
"groom_lord_sees_bride_lord_as": "friend",
"rule": "natural friendship between the Moon-sign lords, read both ways"
}
},
"vasya": {
"matched": true,
"from_ashtakoot": "vashya",
"points_there": 2,
"out_of_there": 2,
"detail": {
"points": 2,
"max": 2,
"bride": "Chatushpada",
"groom": "Chatushpada",
"rule": "from the vashya class of each Moon sign"
}
},
"rajju": {
"matched": false,
"detail": {
"bride": "Siro",
"groom": "Siro",
"dosha": true,
"signifies": "the gravest of the five; danger to the husband",
"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": "Mrigashira",
"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": 6,
"out_of": 10,
"matched": [
"gana",
"yoni",
"rasi"
],
"essential": [
"dina",
"gana",
"yoni"
],
"essential_failed": [
"dina",
"rajju"
],
"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…",
"**6 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": [
"**dina and rajju did not agree, and are 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…",
"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"
}
},
"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.",
"conclusion": {
"verdict": "workable",
"serious": [],
"concerns": [
{
"check": "rajju",
"text": "Rajju dosha: both birth stars fall in the same group (the same part of the body in this check). Rajju is read mainly in the south, as a caution about the couple's well-being."
}
],
"strengths": [
{
"check": "score_good",
"text": "The points are strong: 35 out of 36."
},
{
"check": "nadi_relieved",
"text": "Nadi dosha (the fault from sharing the same nadi) is present, but a standard classical exception removes it."
},
{
"check": "bhakoot_clear",
"text": "Bhakoot, the Moon-sign check, is clear."
}
],
"noted": [
{
"check": "dashakoot",
"text": "In the southern 10-check system, these mandatory checks do not agree: dina and rajju. This happens in most pairs, so it is noted here and not counted in the verdict."
}
],
"not_checked": [
{
"check": "mangal",
"text": "Manglik balance was not checked here, because it needs both full charts."
},
{
"check": "papa",
"text": "The balance of difficult planets was not checked here, because it needs both full charts."
},
{
"check": "cross_affliction",
"text": "The 7th house ruler check was not run here, because it needs both full charts."
}
],
"total": 35,
"out_of": 36,
"essential_failed": [
"dina",
"rajju"
],
"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 35 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,
"not_computed": [
"the mangal comparison -- needs each chart's Mars",
"papa samyam -- needs every papa graha in both charts",
"the two whole charts read against each other (/v1/matching/parasparam)"
]
}Example from a real call. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Kundli matching.
Each person's planets placed in the other's chart
POST /v1/matching/parasparam
Places each person's planets in the other person's houses (bhavas). For example, his Jupiter may fall in her 7th house, or her Saturn in his 4th. This is the part /v1/matching leaves out, because its 36 points use only the two Moons. Rulebook KM-10 (the API's rule reference) names this gap. Readings are included.
Not symmetric, so it is returned both ways. His planets in her houses is a different reading from hers in his. Neither is averaged into the other.
Nothing is scored. Tradition gives no point value for a planet landing in another person's house. A total here would look like the 36-point score while resting on nothing. Instead, placements are grouped by the kind of house. The kinds are kendra (angular houses 1, 4, 7 and 10) and trikona (trine houses 1, 5 and 9). Then dusthana (difficult houses 6, 8 and 12) and upachaya (growth houses 3, 6, 10 and 11). They are also grouped by the relationship themes they bear on. Benefic (helpful) and malefic (harmful) planets are counted separately and never netted off.
The marriage houses (7, 2 and 4) and the friendship houses (11, 5 and 3) are weighed separately. So "would these two be good friends?" and "should these two marry?" can get different answers.
A composite (midpoint) chart and degree-based aspects between the two charts are not calculated. They come from Western astrology and have no counterpart here. See rulebook section PS.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| bride | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
| groom | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
Optional inputs (2), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
Main response fields
bride_grahas_in_groom_houses(object): holds by_house, placements, host_ascendant.groom_grahas_in_bride_houses(object): holds by_house, placements, host_ascendant.marriage_bhavas(object): holds bride_on_groom, groom_on_bride, read_from, text, language, detail.friendship_bhavas(object): holds bride_on_groom, groom_on_bride, read_from, text, language, detail.conjunctions(array of objects): each item holds first, second, sign, same_graha.bride_aspects_groom(array of objects): each item holds from, to, in_sign, special.groom_aspects_bride(array of objects): each item holds from, to, in_sign, special.cross_affliction(object): holds bride_seventh_lord, groom_seventh_lord, afflicted, afflicted_directions, provenance, rule, basis, not_classical.rule(string)asymmetric(string)not_scored(string)not_computed(array of strings)framing(object): holds title, text, language, detail.readings(object): holds conjunctions, bride_aspects_groom, groom_aspects_bride.gaps(array)language(string)detail(string)meta(object): holds bride, groom.
# 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/parasparam" \
-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"}}'{
"bride_grahas_in_groom_houses": {
"by_house": {
"3": [
{
"graha": "Moon",
"sign": 8,
"falls_in_house": 3,
"house_is": [
"upachaya"
],
"theme_en": "effort, courage and the ordinary daily contact",
"nature": "malefic",
"nature_because": "waning"
}
],
"4": [
{
"graha": "Rahu",
"sign": 9,
"falls_in_house": 4,
"house_is": [
"kendra"
],
"theme_en": "home, comfort and peace of mind",
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"5": [
{
"graha": "Saturn",
"sign": 10,
"falls_in_house": 5,
"house_is": [
"trikona"
],
"theme_en": "affection, romance and children",
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"6": [
{
"graha": "Mars",
"sign": 11,
"falls_in_house": 6,
"house_is": [
"dusthana",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
},
{
"graha": "Venus",
"sign": 11,
"falls_in_house": 6,
"house_is": [
"dusthana",
"upachaya"
],
"theme_en": null,
"nature": "benefic",
"nature_because": "benefic by nature"
}
],
"7": [
{
"graha": "Sun",
"sign": 12,
"falls_in_house": 7,
"house_is": [
"kendra"
],
"theme_en": "the partnership itself",
"nature": "malefic",
"nature_because": "malefic by nature"
},
{
"graha": "Mercury",
"sign": 12,
"falls_in_house": 7,
"house_is": [
"kendra"
],
"theme_en": "the partnership itself",
"nature": "malefic",
"nature_because": "sharing a sign with Sun"
}
],
"10": [
{
"graha": "Ketu",
"sign": 3,
"falls_in_house": 10,
"house_is": [
"kendra",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"12": [
{
"graha": "Jupiter",
"sign": 5,
"falls_in_house": 12,
"house_is": [
"dusthana"
],
"theme_en": "the bed, expenditure and what is given up",
"nature": "benefic",
"nature_because": "benefic by nature"
}
]
},
"placements": [
{
"graha": "Sun",
"sign": 12,
"falls_in_house": 7,
"house_is": [
"kendra"
],
"theme_en": "the partnership itself",
"nature": "malefic",
"nature_because": "malefic by nature"
},
{
"graha": "Moon",
"sign": 8,
"falls_in_house": 3,
"house_is": [
"upachaya"
],
"theme_en": "effort, courage and the ordinary daily contact",
"nature": "malefic",
"nature_because": "waning"
},
{
"graha": "Mars",
"sign": 11,
"falls_in_house": 6,
"house_is": [
"dusthana",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"host_ascendant": 6
},
"groom_grahas_in_bride_houses": {
"by_house": {
"1": [
{
"graha": "Mercury",
"sign": 5,
"falls_in_house": 1,
"house_is": [
"kendra",
"trikona"
],
"theme_en": null,
"nature": "benefic",
"nature_because": "unafflicted by association"
}
],
"5": [
{
"graha": "Saturn",
"sign": 9,
"falls_in_house": 5,
"house_is": [
"trikona"
],
"theme_en": "affection, romance and children",
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"6": [
{
"graha": "Rahu",
"sign": 10,
"falls_in_house": 6,
"house_is": [
"dusthana",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"9": [
{
"graha": "Mars",
"sign": 1,
"falls_in_house": 9,
"house_is": [
"trikona"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"10": [
{
"graha": "Moon",
"sign": 2,
"falls_in_house": 10,
"house_is": [
"kendra",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "waning"
}
],
"12": [
{
"graha": "Sun",
"sign": 4,
"falls_in_house": 12,
"house_is": [
"dusthana"
],
"theme_en": "the bed, expenditure and what is given up",
"nature": "malefic",
"nature_because": "malefic by nature"
},
{
"graha": "Jupiter",
"sign": 4,
"falls_in_house": 12,
"house_is": [
"dusthana"
],
"theme_en": "the bed, expenditure and what is given up",
"nature": "benefic",
"nature_because": "benefic by nature"
},
{
"graha": "Venus",
"sign": 4,
"falls_in_house": 12,
"house_is": [
"dusthana"
],
"theme_en": "the bed, expenditure and what is given up",
"nature": "benefic",
"nature_because": "benefic by nature"
}
]
},
"placements": [
{
"graha": "Sun",
"sign": 4,
"falls_in_house": 12,
"house_is": [
"dusthana"
],
"theme_en": "the bed, expenditure and what is given up",
"nature": "malefic",
"nature_because": "malefic by nature"
},
{
"graha": "Moon",
"sign": 2,
"falls_in_house": 10,
"house_is": [
"kendra",
"upachaya"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "waning"
},
{
"graha": "Mars",
"sign": 1,
"falls_in_house": 9,
"house_is": [
"trikona"
],
"theme_en": null,
"nature": "malefic",
"nature_because": "malefic by nature"
}
],
"host_ascendant": 5
},
"marriage_bhavas": {
"bride_on_groom": {
"houses": [
{
"house": 7,
"theme": "the partnership itself",
"theme_en": "the partnership itself",
"text": [
"**The bride's Sun and Mercury fall in the groom's seventh house**. This touches the commitment of marriage itself, since the seventh house covers the partner and the partnership.",
"The seventh is the most important house in this kind of reading. Planets here shape how the groom feels the bride's presence, loyalty and company day to day. So they do a lot to shape your bond over the long run.",
"The usual 36-point matching also leaves this house out, because it looks only at the two Moons. What helps: read the planets named here closely, and talk together about what each of you expects from a partner."
],
"language": "en",
"detail": "standard",
"grahas": [
"Sun",
"Mercury"
],
"benefics": [],
"malefics": [
"Sun",
"Mercury"
],
"parts": [
{
"nature": "malefic",
"text": [
"Where Sun and Mercury sit, this part of the relationship needs attention and maturity. Malefic planets, the naturally harsh ones, are not a bad sign on their own. They build discipline, resilience and strength. In upachaya houses (the…"
],
"language": "en",
"detail": "standard"
}
]
},
{
"house": 2,
"theme": "the family formed, and what is spoken within it",
"theme_en": "the family formed, and what is spoken within it",
"text": [
"**None of the bride's planets fall in the groom's second house (the family formed, and what is spoken within it).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The bride puts no outside pressure on this part of the groom's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
},
{
"house": 4,
"theme": "home, comfort and peace of mind",
"theme_en": "home, comfort and peace of mind",
"text": [
"**The bride's Rahu falls in the groom's fourth house**. This house covers the feel of your home, comfort, family roots and peace of mind.",
"The fourth house is about rest and peace, because it is where a person relaxes in private. Planets here shape how your shared home feels to the groom. Supportive planets tend to make it a calm place where you both feel looked after and…",
"What helps: keep some part of home life quiet and shared, such as a meal or an evening routine. Talk early when home starts to feel tense."
],
"language": "en",
"detail": "standard",
"grahas": [
"Rahu"
],
"benefics": [],
"malefics": [
"Rahu"
],
"parts": [
{
"nature": "malefic",
"text": [
"Where Rahu sit, this part of the relationship needs attention and maturity. Malefic planets, the naturally harsh ones, are not a bad sign on their own. They build discipline, resilience and strength. In upachaya houses (the houses of…"
],
"language": "en",
"detail": "standard"
}
]
}
],
"visitor": "bride",
"host": "groom",
"visitor_en": "bride",
"host_en": "groom"
},
"groom_on_bride": {
"houses": [
{
"house": 7,
"theme": "the partnership itself",
"theme_en": "the partnership itself",
"text": [
"**None of the groom's planets fall in the bride's seventh house (the partnership itself).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The groom puts no outside pressure on this part of the bride's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
},
{
"house": 2,
"theme": "the family formed, and what is spoken within it",
"theme_en": "the family formed, and what is spoken within it",
"text": [
"**None of the groom's planets fall in the bride's second house (the family formed, and what is spoken within it).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The groom puts no outside pressure on this part of the bride's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
},
{
"house": 4,
"theme": "home, comfort and peace of mind",
"theme_en": "home, comfort and peace of mind",
"text": [
"**None of the groom's planets fall in the bride's fourth house (home, comfort and peace of mind).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The groom puts no outside pressure on this part of the bride's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
}
],
"visitor": "groom",
"host": "bride",
"visitor_en": "groom",
"host_en": "bride"
},
"read_from": [
7,
2,
4
],
"text": [
"**The main houses for marriage are 7, 2 and 4.** The seventh holds the marriage itself, and the second looks after your shared home and how you speak. The fourth protects your peace of mind at home.",
"These three are read in both directions. That way you can see whether each of you gets a secure, loving and supportive relationship. They matter most because together they cover the commitment, daily family life and the feeling of home."
],
"language": "en",
"detail": "standard"
},
"friendship_bhavas": {
"bride_on_groom": {
"houses": [
{
"house": 11,
"theme": "friendship, gain and the company kept",
"theme_en": "friendship, gain and the company kept",
"text": [
"**None of the bride's planets fall in the groom's eleventh house (friendship, gain and the company kept).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The bride puts no outside pressure on this part of the groom's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
},
{
"house": 5,
"theme": "affection, romance and children",
"theme_en": "affection, romance and children",
"text": [
"**The bride's Saturn falls in the groom's fifth house**. This house covers romance, creativity, children and simply enjoying each other's company.",
"The fifth house is about liking each other and laughing together, not duty. Planets here help ground your relationship in real friendship, playfulness and things you both love doing. That is often what carries a couple through busy years.",
"In daily life it shows in shared jokes, hobbies and how you feel about children. What helps: keep some time just for fun, with no chores or planning attached."
],
"language": "en",
"detail": "standard",
"grahas": [
"Saturn"
],
"benefics": [],
"malefics": [
"Saturn"
],
"parts": [
{
"nature": "malefic",
"text": [
"Where Saturn sit, this part of the relationship needs attention and maturity. Malefic planets, the naturally harsh ones, are not a bad sign on their own. They build discipline, resilience and strength. In upachaya houses (the houses of…"
],
"language": "en",
"detail": "standard"
}
]
},
{
"house": 3,
"theme": "effort, courage and the ordinary daily contact",
"theme_en": "effort, courage and the ordinary daily contact",
"text": [
"**The bride's Moon falls in the groom's third house**. This house covers everyday talk, starting things together, encouraging each other and working as a team.",
"This house is about the small daily efforts that keep a marriage going over the years. The third is an upachaya house, a house that improves with time. So the teamwork and friendship built here tend to get stronger each year.",
"In daily life it shows in messages through the day, shared chores and how you cheer each other on. What helps: keep talking about small things, and take on little projects together."
],
"language": "en",
"detail": "standard",
"grahas": [
"Moon"
],
"benefics": [],
"malefics": [
"Moon"
],
"parts": [
{
"nature": "malefic",
"text": [
"Where Moon sit, this part of the relationship needs attention and maturity. Malefic planets, the naturally harsh ones, are not a bad sign on their own. They build discipline, resilience and strength. In upachaya houses (the houses of…"
],
"language": "en",
"detail": "standard"
}
]
}
],
"visitor": "bride",
"host": "groom",
"visitor_en": "bride",
"host_en": "groom"
},
"groom_on_bride": {
"houses": [
{
"house": 11,
"theme": "friendship, gain and the company kept",
"theme_en": "friendship, gain and the company kept",
"text": [
"**None of the groom's planets fall in the bride's eleventh house (friendship, gain and the company kept).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The groom puts no outside pressure on this part of the bride's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
},
{
"house": 5,
"theme": "affection, romance and children",
"theme_en": "affection, romance and children",
"text": [
"**The groom's Saturn falls in the bride's fifth house**. This house covers romance, creativity, children and simply enjoying each other's company.",
"The fifth house is about liking each other and laughing together, not duty. Planets here help ground your relationship in real friendship, playfulness and things you both love doing. That is often what carries a couple through busy years.",
"In daily life it shows in shared jokes, hobbies and how you feel about children. What helps: keep some time just for fun, with no chores or planning attached."
],
"language": "en",
"detail": "standard",
"grahas": [
"Saturn"
],
"benefics": [],
"malefics": [
"Saturn"
],
"parts": [
{
"nature": "malefic",
"text": [
"Where Saturn sit, this part of the relationship needs attention and maturity. Malefic planets, the naturally harsh ones, are not a bad sign on their own. They build discipline, resilience and strength. In upachaya houses (the houses of…"
],
"language": "en",
"detail": "standard"
}
]
},
{
"house": 3,
"theme": "effort, courage and the ordinary daily contact",
"theme_en": "effort, courage and the ordinary daily contact",
"text": [
"**None of the groom's planets fall in the bride's third house (effort, courage and the ordinary daily contact).**",
"An empty house is a neutral finding, and a freeing one: not a gap in the reading and not a warning sign. The groom puts no outside pressure on this part of the bride's life. So you are both free to shape it together by your own choices.…"
],
"language": "en",
"detail": "standard",
"grahas": [],
"benefics": [],
"malefics": []
}
],
"visitor": "groom",
"host": "bride",
"visitor_en": "groom",
"host_en": "bride"
},
"read_from": [
11,
5,
3
],
"text": [
"**The main houses for friendship are 11, 5 and 3.** The eleventh shows shared goals and companionship. The fifth shows the fun and creativity you share, and the third your everyday talk and initiative.",
"This shows whether, beyond romance, you are likely to be real companions who think alike. That matters because friendship is often what keeps a marriage warm once the first excitement settles."
],
"language": "en",
"detail": "standard"
},
"conjunctions": [
{
"first": "Jupiter",
"second": "Mercury",
"sign": 5,
"same_graha": false
},
{
"first": "Saturn",
"second": "Rahu",
"sign": 10,
"same_graha": false
},
{
"first": "Rahu",
"second": "Saturn",
"sign": 9,
"same_graha": false
}
],
"bride_aspects_groom": [
{
"from": "Moon",
"to": "Moon",
"in_sign": 2,
"special": false
},
{
"from": "Mars",
"to": "Moon",
"in_sign": 2,
"special": false
},
{
"from": "Mars",
"to": "Mercury",
"in_sign": 5,
"special": false
}
],
"groom_aspects_bride": [
{
"from": "Sun",
"to": "Saturn",
"in_sign": 10,
"special": false
},
{
"from": "Moon",
"to": "Moon",
"in_sign": 8,
"special": false
},
{
"from": "Mars",
"to": "Moon",
"in_sign": 8,
"special": false
}
],
"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"
},
"rule": "each native's grahas placed in the other's whole-sign bhavas, classified by the bhava's own nature and by the themes a relationship is read from",
"asymmetric": "his grahas in her houses is a different reading from hers in his. Both are returned and neither is averaged into the other",
"not_scored": "there is no classical point value for a graha landing on another chart's bhava. The placements are classified and counted; no total is produced, because a number here would look like the thirty-six and rest on nothing",
"not_computed": [
"the midpoint composite chart, which has no counterpart in this tradition",
"degree-based aspects between the two charts, which are a different school's technique"
],
"framing": {
"title": "The two charts read against each other",
"text": [
"**The usual guna milan looks at only two things: the two Moons.** This 36-point matching checks the birth nakshatras (lunar mansions) and Moon signs. It leaves out the ascendants, the seventh houses of marriage and where Venus and Jupiter…",
"Every planet in the bride's chart is placed in the groom's 12 houses. And every planet in the groom's chart is placed in the bride's houses. Whole-sign houses are used, so each sign counts as one whole house and nothing depends on…",
"**The charts are read both ways, because each of you experiences the other differently.** His planets in her fourth and her planets in his fourth describe two different experiences of the same home. What follows sets these out plainly,…"
],
"language": "en",
"detail": "standard"
},
"readings": {
"conjunctions": {
"text": [
"**Your two charts have 3 conjunctions between them.** A conjunction here means a planet in one chart sits in the same sign as a planet in the other.",
"These are direct links, because the two planets share a sign. Where supportive planets meet, you tend to click right away. Where difficult planets meet, some understanding for each other helps you line up your goals.",
"What helps: look at which planets are involved in each link, and give extra patience to the ones that involve the harsher planets."
],
"language": "en",
"detail": "standard"
},
"bride_aspects_groom": {
"text": [
"**Your two charts have 13 aspect (drishti) contacts.** In each, a planet in one partner's chart looks at a planet in the other's. Drishti is the classical idea of a planet's gaze reaching certain houses from where it sits.",
"Aspects show how you see, inspire and reflect each other's feelings. They point to the quiet ways you make your partner more aware and help them grow. Often neither of you notices it happening."
],
"language": "en",
"detail": "standard"
},
"groom_aspects_bride": {
"text": [
"**Your two charts have 17 aspect (drishti) contacts.** In each, a planet in one partner's chart looks at a planet in the other's. Drishti is the classical idea of a planet's gaze reaching certain houses from where it sits.",
"Aspects show how you see, inspire and reflect each other's feelings. They point to the quiet ways you make your partner more aware and help them grow. Often neither of you notices it happening."
],
"language": "en",
"detail": "standard"
}
},
"gaps": [],
"language": "en",
"detail": "standard",
"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"
}
}
}
}Example from a real call for Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Kundli matching.
Love, career or wealth forecast for a couple
POST /v1/forecast/couple/{theme}
Returns each person's own forecast for one theme (love, career or wealth). It also shows what neither forecast shows alone: what the two people share.
A transit is one sky event, read twice. Jupiter entering Cancer is a single fact. But it falls in a different house for each person, because houses are counted from each person's own rising sign (lagna). Whether it helps or tests is still counted from each person's birth Moon. When the same event lands in both people's theme houses at once, that is a real joint signal. It is the one thing here you could not get by reading two forecasts side by side. Both house numbers are returned; merging them would invent a house the sky does not have.
Periods overlap by date. The two people run different dashas (planetary periods). What matters is the stretch when both are in a period whose ruling planet relates to the theme. Periods weigh more than transits, so this is the more significant overlap.
Nothing is merged and nothing is scored. Two charts are not averaged into one, because the result would describe a person who does not exist; this is why no composite chart is offered (rulebook PS-05, the API's rule reference). For love, the response also shows how each person's planets fall in the other's marriage houses (as in /v1/matching/parasparam). That part does not change with the date range. See rulebook section OL.
The date range is one year by default and 12 months at most. A longer range returns 422; ask for the next months in another call.
The request names the two people bride and groom, as in /v1/matching.
Uses 6 reading credits. On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys return this reading for the sample charts only, and it counts as 1 test call. The X-Reading-Credits-Counted header says what a response used. What reading credits buy.
Cost: Uses reading credits on live keys instead of monthly calls. On test keys it counts as 1 call.
Required inputs
| Name | In | What it is |
|---|---|---|
| theme | path | The theme to follow: love, career or wealth. |
| bride | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
| groom | body | The date, time and place of birth. Endpoints that read a birth chart take this as the request body. |
Optional inputs (4), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
| from | query | Start date, YYYY-MM-DD. Defaults to today. |
| to | query | End date, YYYY-MM-DD. Defaults to one year after the start, and can be at most 12 months after it. |
Main response fields
theme(string)window(object): holds from, to.bride(object): holds theme, focus, read_from, houses, lords, karakas, window, not_ranked, framing, transits, clashes, periods.groom(object): holds theme, focus, read_from, houses, lords, karakas, window, not_ranked, framing, transits, clashes, periods.read_from(string)shared_transits(array)shared_periods(array of objects): each item holds from, to, bride_lord, bride_level, bride_why, groom_lord, groom_level, groom_why, same_lord.framing(object): holds text, language, detail.shared_transits_reading(object): holds text, language, detail.shared_periods_reading(object): holds text, language, detail.overlay(object): holds bride_on_groom, groom_on_bride, read_from.not_merged(string)gaps(array)language(string)detail(string)meta(object): holds bride, groom.
# 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/forecast/couple/love?from=2026-10-01&to=2026-12-31" \
-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"}}'{
"theme": "love",
"window": {
"from": "2026-10-01",
"to": "2026-12-31"
},
"bride": {
"theme": "love",
"focus": "love-and-marriage",
"read_from": "the seventh house and its lord, the second, and Venus",
"houses": [
7,
2,
12
],
"lords": [
7,
2
],
"karakas": [
"Venus",
"Jupiter"
],
"window": {
"from": "2026-10-01",
"to": "2026-12-31"
},
"not_ranked": "a transit and a mahadasha are not on one scale -- one lasts weeks and the other twenty years. They are two lists with their dates, and no number puts them in order",
"framing": {
"text": [
"**This is your love and marriage forecast for the time ahead.** It reads your 7th, 2nd and 12th houses, the parts of your chart for marriage and close bonds. It also follows the planets that stand for love in your chart (Venus and Jupiter).",
"Two clocks run at once. **Transits**, the planets moving through your chart now, are the weather: they come and go in weeks or months. Your **running mahadasha and antardasha** are the long period and the shorter sub-period you are living…",
"A transit can only bring what your running period allows. Read the two together to see when bigger steps in love are more likely. You can also see how to use the quieter stretches. What you can do: save the big steps, such as a proposal or…"
],
"language": "en",
"detail": "standard"
},
"transits": [
{
"graha": "Sun",
"house_from_moon": 11,
"sign": "Virgo",
"starts": "2026-10-01T00:00:00",
"ends": "2026-10-17T09:21:43",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "favorable",
"vedha_house": 5,
"bindus": 4,
"strength": "moderate",
"natal_house": 2,
"why": [
"crossing your 2nd house, counted from your lagna"
],
"transit_reading_id": "transit:Sun:11",
"reading": {
"text": [
"Sun is crossing your 2nd house, the house of family and home life. Until October 17, family tends to back your relationship, so it is a good time for talks at home."
],
"language": "en",
"detail": "standard"
}
},
{
"graha": "Mars",
"house_from_moon": 9,
"sign": "Cancer",
"starts": "2026-10-01T00:00:00",
"ends": "2026-11-12T08:48:38",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "unfavorable",
"vedha_house": null,
"bindus": 5,
"strength": "moderate",
"natal_house": 12,
"why": [
"crossing your 12th house, counted from your lagna"
],
"transit_reading_id": "transit:Mars:9",
"reading": {
"text": [
"Mars is crossing your 12th house, the house of closeness and private time. Until November 12, you may feel tired or far apart, so do not read too much into a quiet patch."
],
"language": "en",
"detail": "standard"
}
},
{
"graha": "Jupiter",
"house_from_moon": 9,
"sign": "Cancer",
"starts": "2026-10-01T00:00:00",
"ends": "2026-10-31T01:32:37",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "favorable",
"vedha_house": 10,
"bindus": 3,
"strength": "weak",
"natal_house": 12,
"why": [
"karaka for this theme",
"crossing your 12th house, counted from your lagna"
],
"transit_reading_id": "transit:Jupiter:9",
"reading": {
"text": [
"Jupiter is crossing your 12th house, the house of closeness and private time. Until October 31, quiet time together tends to bring you closer, so plan a calm evening for two.",
"Jupiter is a natural sign of love in your chart, so its move matters for you. Until October 31, it tends to help affection and trust, so show your care in small ways."
],
"language": "en",
"detail": "standard"
}
}
],
"clashes": [
{
"subject": "house",
"house": 12,
"from": "2026-10-01T00:00:00",
"to": "2026-10-31T01:32:37",
"favorable": "Jupiter",
"unfavorable": "Mars",
"reading": {
"text": [
"**October 1, 2026 to October 31, 2026:** Jupiter and Mars both cross your 12th house at the same time, and they pull opposite ways. You may feel some of each, with help coming beside setbacks. Neither one cancels the other, so take the…"
],
"language": "en",
"detail": "standard"
}
},
{
"subject": "karaka",
"house": null,
"from": "2026-10-31T01:32:37",
"to": "2026-11-05T13:34:22",
"favorable": "Venus",
"unfavorable": "Jupiter",
"reading": {
"text": [
"**October 31, 2026 to November 5, 2026:** Venus and Jupiter, the planets that stand for this part of life in your chart, pull opposite ways at the same time. Good days and harder days can come close together, so judge the stretch as a…"
],
"language": "en",
"detail": "standard"
}
},
{
"subject": "karaka",
"house": null,
"from": "2026-11-05T13:34:22",
"to": "2026-11-22T05:51:08",
"favorable": "Venus",
"unfavorable": "Jupiter",
"reading": {
"text": [
"**November 5, 2026 to November 22, 2026:** Venus and Jupiter, the planets that stand for this part of life in your chart, pull opposite ways at the same time. Good days and harder days can come close together, so judge the stretch as a…"
],
"language": "en",
"detail": "standard"
}
}
],
"periods": [
{
"level": "mahadasha",
"within": null,
"lord": "Mercury",
"lord_name": "Mercury",
"starts": "2013-03-26",
"ends": "2030-03-27",
"years": 17,
"owns_theme_houses": [
2
],
"occupies_house": null,
"is_karaka": false,
"why": [
"rules your 2nd house"
],
"counts": 1,
"reading": {
"text": [
"Mercury stands for thinking, speech and trade. So a Mercury period sharpens your mind and your way with words, and brings business and contacts forward. When it is your major period, it lasts 17 years. Now is an especially good time for…",
"The period is quick and has many parts: several things run at once, and your mind is at its sharpest. The risk: spreading yourself thin rather than failing, with lots of starts and not many finishes.",
"It rewards anything that depends on words or numbers, and it is generous to traders, teachers, writers and negotiators. For health, watch the nerves, the skin and the digestion. What helps: a short list of priorities that you finish before…"
],
"language": "en",
"detail": "standard"
}
},
{
"level": "antardasha",
"within": "Mercury",
"lord": "Jupiter",
"lord_name": "Jupiter",
"starts": "2025-04-11",
"ends": "2027-07-17",
"years": 2.266667,
"owns_theme_houses": [],
"occupies_house": null,
"is_karaka": true,
"why": [
"karaka for this theme"
],
"counts": 1,
"reading": {
"text": [
"Jupiter stands for wisdom, growth and good guidance. So a Jupiter period puts four things at the center: learning, faith, children and steady growth in money. When it is your major period, it lasts 16 years. Doors tend to open through…",
"By nature it is the most protective of the periods. How much of that you feel depends on how Jupiter stands in your chart, and the reading below shows this. At its best, things usually work out: help turns up, and mistakes are forgiven…",
"It rewards study, teaching, giving advice and anything that grows slowly. For health, watch the liver, your weight and the blood. What helps: keep some discipline while life is easy, such as a regular exercise habit and a budget that still…"
],
"language": "en",
"detail": "standard"
}
}
],
"transits_reading": {
"text": [
"**9 transits** touch this part of your life in the window you chose. A transit is a planet moving through one of your houses. Each one is counted two ways. The house from your birth Moon shows whether it helps or strains. The house from…",
"Each transit is read by the house it wakes up and the houses its planet rules. That shows you when doors may open and when it pays to wait. It means the most when you read it next to your running dasha. What you can do: mark the dates…"
],
"language": "en",
"detail": "standard"
},
"periods_reading": {
"text": [
"**2 dasha periods** in this window are run by a planet tied directly to this part of your life. A dasha is a planetary period of your life, and its lord is the planet that runs it.",
"Your mahadasha and antardasha, the long period and the sub-period, set the ground for what your chart can give. So these periods are often your best windows for real, lasting change here. What you can do: put your main effort into these…"
],
"language": "en",
"detail": "standard"
},
"gaps": [],
"language": "en",
"detail": "standard",
"omitted": [
{
"graha": "Moon",
"reason": "changes house 41 times in this window, more than the 14 a timeline lists. Narrow the window, or read it from /v1/transits/ingresses/Moon."
}
]
},
"groom": {
"theme": "love",
"focus": "love-and-marriage",
"read_from": "the seventh house and its lord, the second, and Venus",
"houses": [
7,
2,
12
],
"lords": [
7,
2
],
"karakas": [
"Venus",
"Jupiter"
],
"window": {
"from": "2026-10-01",
"to": "2026-12-31"
},
"not_ranked": "a transit and a mahadasha are not on one scale -- one lasts weeks and the other twenty years. They are two lists with their dates, and no number puts them in order",
"framing": {
"text": [
"**This is your love and marriage forecast for the time ahead.** It reads your 7th, 2nd and 12th houses, the parts of your chart for marriage and close bonds. It also follows the planets that stand for love in your chart (Venus and Jupiter).",
"Two clocks run at once. **Transits**, the planets moving through your chart now, are the weather: they come and go in weeks or months. Your **running mahadasha and antardasha** are the long period and the shorter sub-period you are living…",
"A transit can only bring what your running period allows. Read the two together to see when bigger steps in love are more likely. You can also see how to use the quieter stretches. What you can do: save the big steps, such as a proposal or…"
],
"language": "en",
"detail": "standard"
},
"transits": [
{
"graha": "Mercury",
"house_from_moon": 6,
"sign": "Libra",
"starts": "2026-10-01T00:00:00",
"ends": "2026-12-02T06:57:31",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "favorable",
"vedha_house": 9,
"bindus": 6,
"strength": "strong",
"natal_house": 2,
"why": [
"crossing your 2nd house, counted from your lagna"
],
"transit_reading_id": "transit:Mercury:6",
"reading": {
"text": [
"Mercury is crossing your 2nd house, the house of family and home life. Until December 2, family tends to back your relationship, so it is a good time for talks at home."
],
"language": "en",
"detail": "standard"
}
},
{
"graha": "Jupiter",
"house_from_moon": 3,
"sign": "Cancer",
"starts": "2026-10-01T00:00:00",
"ends": "2026-10-31T02:32:49",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "unfavorable",
"vedha_house": null,
"bindus": 4,
"strength": "moderate",
"natal_house": 11,
"why": [
"karaka for this theme"
],
"transit_reading_id": "transit:Jupiter:3",
"reading": {
"text": [
"Jupiter is a natural sign of love in your chart, so its move matters for you. Until October 31, feelings can run hot and cold, so be patient with each other."
],
"language": "en",
"detail": "standard"
}
},
{
"graha": "Venus",
"house_from_moon": 6,
"sign": "Libra",
"starts": "2026-10-01T00:00:00",
"ends": "2026-11-05T14:34:20",
"entry_known": false,
"exit_known": true,
"resumes_visit": false,
"result": "unfavorable",
"vedha_house": null,
"bindus": 4,
"strength": "moderate",
"natal_house": 2,
"why": [
"karaka for this theme",
"crossing your 2nd house, counted from your lagna"
],
"transit_reading_id": "transit:Venus:6",
"reading": {
"text": [
"Venus is crossing your 2nd house, the house of family and home life. Until November 5, family talks can get heated, so choose your words with care.",
"Venus is a natural sign of love in your chart, so its move matters for you. Until November 5, feelings can run hot and cold, so be patient with each other."
],
"language": "en",
"detail": "standard"
}
}
],
"clashes": [
{
"subject": "house",
"house": 2,
"from": "2026-10-01T00:00:00",
"to": "2026-11-05T14:34:20",
"favorable": "Mercury",
"unfavorable": "Venus",
"reading": {
"text": [
"**October 1, 2026 to November 5, 2026:** Mercury and Venus both cross your 2nd house at the same time, and they pull opposite ways. You may feel some of each, with help coming beside setbacks. Neither one cancels the other, so take the…"
],
"language": "en",
"detail": "standard"
}
},
{
"subject": "house",
"house": 2,
"from": "2026-10-17T10:21:43",
"to": "2026-11-05T14:34:20",
"favorable": "Sun",
"unfavorable": "Venus",
"reading": {
"text": [
"**October 17, 2026 to November 5, 2026:** Sun and Venus both cross your 2nd house at the same time, and they pull opposite ways. You may feel some of each, with help coming beside setbacks. Neither one cancels the other, so take the help…"
],
"language": "en",
"detail": "standard"
}
},
{
"subject": "karaka",
"house": null,
"from": "2026-11-05T14:34:20",
"to": "2026-11-22T06:51:08",
"favorable": "Venus",
"unfavorable": "Jupiter",
"reading": {
"text": [
"**November 5, 2026 to November 22, 2026:** Venus and Jupiter, the planets that stand for this part of life in your chart, pull opposite ways at the same time. Good days and harder days can come close together, so judge the stretch as a…"
],
"language": "en",
"detail": "standard"
}
}
],
"periods": [
{
"level": "mahadasha",
"within": null,
"lord": "Jupiter",
"lord_name": "Jupiter",
"starts": "2014-12-20",
"ends": "2030-12-20",
"years": 16,
"owns_theme_houses": [
7
],
"occupies_house": null,
"is_karaka": true,
"why": [
"rules your 7th house",
"karaka for this theme"
],
"counts": 2,
"reading": {
"text": [
"Jupiter stands for wisdom, growth and good guidance. So a Jupiter period puts four things at the center: learning, faith, children and steady growth in money. When it is your major period, it lasts 16 years. Doors tend to open through…",
"By nature it is the most protective of the periods. How much of that you feel depends on how Jupiter stands in your chart, and the reading below shows this. At its best, things usually work out: help turns up, and mistakes are forgiven…",
"It rewards study, teaching, giving advice and anything that grows slowly. For health, watch the liver, your weight and the blood. What helps: keep some discipline while life is easy, such as a regular exercise habit and a budget that still…"
],
"language": "en",
"detail": "standard"
}
}
],
"transits_reading": {
"text": [
"**10 transits** touch this part of your life in the window you chose. A transit is a planet moving through one of your houses. Each one is counted two ways. The house from your birth Moon shows whether it helps or strains. The house from…",
"Each transit is read by the house it wakes up and the houses its planet rules. That shows you when doors may open and when it pays to wait. It means the most when you read it next to your running dasha. What you can do: mark the dates…"
],
"language": "en",
"detail": "standard"
},
"periods_reading": {
"text": [
"**One dasha period** in your forecast window is tied to this part of your life. A dasha is a long planetary period. While this one runs, it tends to bring this area to the front.",
"The entry below says why its planet was chosen. A transit can only add to what your running period allows. What you can do: use this period on purpose, and set one clear goal for this area before it begins or early in it."
],
"language": "en",
"detail": "standard"
},
"gaps": [],
"language": "en",
"detail": "standard",
"omitted": [
{
"graha": "Moon",
"reason": "changes house 41 times in this window, more than the 14 a timeline lists. Narrow the window, or read it from /v1/transits/ingresses/Moon."
}
]
},
"read_from": "the seventh house and its lord, the second, and Venus",
"shared_transits": [],
"shared_periods": [
{
"from": "2026-10-01",
"to": "2026-12-31",
"bride_lord": "Mercury",
"bride_level": "mahadasha",
"bride_why": [
"rules your 2nd house"
],
"groom_lord": "Jupiter",
"groom_level": "mahadasha",
"groom_why": [
"rules your 7th house",
"karaka for this theme"
],
"same_lord": false
},
{
"from": "2026-10-01",
"to": "2026-12-31",
"bride_lord": "Jupiter",
"bride_level": "antardasha",
"bride_why": [
"karaka for this theme"
],
"groom_lord": "Jupiter",
"groom_level": "mahadasha",
"groom_why": [
"rules your 7th house",
"karaka for this theme"
],
"same_lord": true
}
],
"framing": {
"text": [
"**This puts both of your forecasts side by side.** Each of you has your own cycles. The same sky event can touch this part of life in both charts at once. When it does, it tends to come to the front for you as a couple.",
"Below you can see where your transits and running dasha periods line up. Those are the windows when the same part of life is busy for both of you. Nothing is blended into one combined chart, because each of you keeps your own reading. What…"
],
"language": "en",
"detail": "standard"
},
"shared_transits_reading": {
"text": [
"**In this window, no single transit touches this part of life for both of you at once.** Each of you keeps your own rhythm, as your own forecasts show.",
"For a couple, this is normal, because each chart's houses are counted from that person's own rising sign (lagna). Your houses usually fall in different signs. It only means that what happens here now is led mostly by each person's own…"
],
"language": "en",
"detail": "standard"
},
"shared_periods_reading": {
"text": [
"**2 windows in this period have you both running periods that support this shared part of life.**",
"A dasha period shows what each chart can give at a certain time, so overlaps like these matter. These tend to be your better times for milestones or a big step together. What you can do: pick the window that suits you both best, and plan…"
],
"language": "en",
"detail": "standard"
},
"overlay": {
"bride_on_groom": {
"2": {
"theme_en": "the family formed, and what is spoken within it",
"house_is": [],
"grahas": [],
"benefics": [],
"malefics": []
},
"4": {
"theme_en": "home, comfort and peace of mind",
"house_is": [
"kendra"
],
"grahas": [
"Rahu"
],
"benefics": [],
"malefics": [
"Rahu"
]
},
"7": {
"theme_en": "the partnership itself",
"house_is": [
"kendra"
],
"grahas": [
"Sun",
"Mercury"
],
"benefics": [],
"malefics": [
"Sun",
"Mercury"
]
}
},
"groom_on_bride": {
"2": {
"theme_en": "the family formed, and what is spoken within it",
"house_is": [],
"grahas": [],
"benefics": [],
"malefics": []
},
"4": {
"theme_en": "home, comfort and peace of mind",
"house_is": [
"kendra"
],
"grahas": [],
"benefics": [],
"malefics": []
},
"7": {
"theme_en": "the partnership itself",
"house_is": [
"kendra"
],
"grahas": [],
"benefics": [],
"malefics": []
}
},
"read_from": [
7,
2,
4
]
},
"not_merged": "each native keeps their own forecast; the shared set is reported beside them and never instead of them. Two charts are not averaged into one",
"gaps": [],
"language": "en",
"detail": "standard",
"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"
}
}
}
}Example from a real call for Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Kundli matching.
How we check the numbers
Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. 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 sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test accuracy.
Related pages
- Features: Kundli matching.
- Used for: Matrimony and matchmaking sites, Astrology apps, AI assistants and chatbots, Dating and compatibility apps.
- Free tools: Kundli matching.
- Rules: Kundli matching (guna milan), Pair reading.
- Guides: Quickstart, Conventions, Errors, Changelog.
