Ashtakoota (36-point) Guna Milan matching, Mangal Dosha assessment, and Western synastry — all via API. Integrate marriage compatibility into matrimonial sites, dating apps, and astrology platforms.
The Ashtakoota system compares the Moon nakshatras of two individuals across 8 criteria (ashta = eight, koota = category). Each criterion has a maximum score. The total across all 8 is 36 points. Scores above 18 are generally considered favorable for marriage.
Compares the spiritual development level (Brahmin, Kshatriya, Vaishya, Shudra) based on Moon nakshatra. The groom's varna should be equal or higher than the bride's.
Assesses the power dynamic and mutual attraction between the couple based on Moon sign categories (human, quadruped, insect, aquatic, wild).
Evaluates health and well-being of the couple by counting nakshatras from one person's birth star to the other's, checking the remainder against favorable groups.
Checks physical and sexual compatibility using animal symbols assigned to each nakshatra (14 animal pairs). Same animal = 4 points. Enemy animals = 0.
Compares the friendship between Moon sign lords of both partners. Mutual friends = 5, one friend + one neutral = 4, both neutral = 3, etc.
Matches temperament types: Deva (divine/gentle), Manushya (human/pragmatic), Rakshasa (assertive/independent). Same gana = 6 points.
Checks the Moon sign distance between partners for prosperity and emotional bonding. Certain combinations (2/12, 6/8, 5/9) reduce points. No adverse combo = 7 points.
The most critical criterion. Compares the Ayurvedic constitution (Aadi/Madhya/Antya) based on nakshatra. Same nadi = 0 points (highest concern). Different nadi = 8 points.
| Score Range | Interpretation | Recommendation |
|---|---|---|
| 0 – 17 | Not Recommended | Significant challenges. Consult astrologer for exceptions. |
| 18 – 24 | Average / Acceptable | Workable match. Check doshas individually. |
| 25 – 32 | Good Match | Strong compatibility across most criteria. |
| 33 – 36 | Excellent Match | Highly compatible. Rare score range. |
curl -X POST https://api.vedika.io/v2/astrology/guna-milan \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"partner1": {
"datetime": "1992-03-15T08:00:00",
"latitude": 19.0760,
"longitude": 72.8777,
"timezone": "+05:30"
},
"partner2": {
"datetime": "1994-07-22T14:30:00",
"latitude": 28.6139,
"longitude": 77.2090,
"timezone": "+05:30"
}
}'
{
"success": true,
"data": {
"totalScore": 28,
"maxScore": 36,
"recommendation": "Good Match",
"criteria": {
"varna": { "score": 1, "maxScore": 1, "description": "Spiritual compatibility" },
"vashya": { "score": 2, "maxScore": 2, "description": "Mutual attraction" },
"tara": { "score": 3, "maxScore": 3, "description": "Health & well-being" },
"yoni": { "score": 3, "maxScore": 4, "description": "Physical compatibility" },
"grahaMaitri":{ "score": 5, "maxScore": 5, "description": "Mental compatibility" },
"gana": { "score": 6, "maxScore": 6, "description": "Temperament match" },
"bhakoot": { "score": 7, "maxScore": 7, "description": "Love & prosperity" },
"nadi": { "score": 1, "maxScore": 8, "description": "Health & genetics" }
},
"partner1Moon": { "sign": "Cancer", "nakshatra": "Pushya", "pada": 2 },
"partner2Moon": { "sign": "Sagittarius", "nakshatra": "Purva Ashadha", "pada": 1 }
}
}
Mangal Dosha (Mars affliction) is checked when Mars occupies the 1st, 2nd, 4th, 7th, 8th, or 12th house from the ascendant, Moon, or Venus. When one partner has Mangal Dosha and the other does not, it is traditionally considered a mismatch.
The API checks Mangal Dosha for each partner independently and reports severity (mild, moderate, severe) along with any cancellation conditions (e.g., Mars aspected by Jupiter, Mars in own sign).
For Western astrology compatibility, Vedika offers synastry analysis using the tropical zodiac. The synastry endpoint compares two natal charts and returns inter-chart aspects (conjunctions, trines, squares, oppositions, sextiles between one person's planets and the other's). Also available: composite chart generation for the relationship itself.
Synastry is a separate system from Vedic Ashtakoota matching. The two systems use different zodiacs (tropical vs. sidereal) and different matching criteria. Vedika keeps them completely isolated — no cross-contamination of terminology or methodology.