The Match Ashtakoot Points API computes the Ashtakoot Guna Milan score — the most widely used and authoritative Vedic astrology system for assessing marriage compatibility between two individuals. Ashtakoot (literally "eight categories") evaluates the compatibility of a couple across eight distinct Kootas (compatibility dimensions), each derived from the Janma Nakshatra (birth lunar mansion) of both individuals. Each Koota carries a specific maximum point value, and the scores are summed to produce a total out of 36 — the definitive compatibility score in traditional Vedic matchmaking.
The API accepts complete birth date, time, and geographic coordinates for both the male and female, calculates their respective Janma Nakshatras using the specified Ayanamsha, and returns the individual score for each of the eight Kootas along with the aggregate compatibility score and its interpretive assessment.
What data it returns
- Individual scores for each of the eight Kootas, along with the maximum possible score for each:
- Varna (1 point) — spiritual compatibility and ego levels
- Vashya (2 points) — mutual attraction and dominance
- Tara (3 points) — birth star compatibility and health/longevity
- Yoni (4 points) — sexual and biological compatibility
- Graha Maitri (5 points) — mental compatibility and friendship between Moon sign lords
- Gana (6 points) — temperament and nature compatibility
- Bhakoot (7 points) — emotional and financial compatibility
- Nadi (8 points) — health, progeny, and genetic compatibility
- The aggregate total Guna score out of 36, representing the overall compatibility rating
- An interpretive assessment of the total score indicating the quality of the match (e.g., excellent, good, acceptable, or not recommended)
- Koota-level interpretations explaining the significance of each individual score and what it means for the couple's compatibility in that dimension
- Nakshatra details for both individuals as used in the Koota calculations
- Localised output based on the requested language
Main use cases
- Core Kundali Milan scoring — Delivering the primary compatibility score that is the centrepiece of virtually every Vedic horoscope matching report and matrimonial platform
- Marriage compatibility platforms — Powering the Guna Milan feature in matrimonial websites, apps, and astrology platforms where users expect an Ashtakoot score as the standard output of a match analysis
- Automated matchmaking workflows — Enabling programmatic compatibility screening where the aggregate score is used to filter, rank, or shortlist potential matches from a pool of candidates
- Horoscope matching reports — Providing the Koota-by-Koota breakdown and total score that forms the structured compatibility section of professional Kundali Milan reports
- Compatibility score display — Surfacing the 36-point score and its interpretation as a quick, universally understood compatibility indicator for end users in consumer astrology applications
- Astrological counselling — Assisting practitioners in generating accurate, structured Ashtakoot assessments for client matchmaking consultations
- Multi-system compatibility analysis — Using the Ashtakoot score alongside Mangal Dosha analysis and other matchmaking endpoints to build a comprehensive, multi-dimensional compatibility picture
Key functionality
- Full eight-Koota computation — Calculates all eight Kootas (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi) individually and returns both the raw score and the maximum for each, providing complete transparency into how the total is derived
- 36-point aggregate scoring — Produces the standard total Guna score out of 36 with an interpretive rating, delivering the single most recognised compatibility metric in Vedic matchmaking
- Koota-level interpretation — Goes beyond raw numbers to provide meaningful explanations of what each Koota score signifies for the couple's compatibility in that specific dimension
- Nakshatra-based calculation — Derives all Koota scores from the Janma Nakshatras of both individuals, ensuring the calculations are grounded in the precise lunar mansion positions computed from their birth data
- Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the
X-Ayanamsha header, ensuring accurate sidereal Nakshatra calculations aligned with the preferred Jyotish tradition
- Independent geographic inputs — Accepts separate latitude, longitude, and timezone values for each individual, correctly handling births in different locations and time zones
- Multi-language support — Responses can be localised via the
Accept-Language header, making the API suitable for regional and multilingual matrimonial and astrology platforms
- Matchmaking suite centrepiece — Serves as the primary compatibility scoring endpoint within the AstroInsight matchmaking suite, designed to be used in conjunction with Match Birth Details, Match Planet Details, and Mangal Dosha endpoints for a complete Kundali Milan analysis
