The Match Astro Details API retrieves the comprehensive astrological chart details for two individuals — a male and a female — within the context of a Kundali Milan (horoscope matching) workflow. While the Match Birth Details endpoint returns the core birth identifiers (Rashi, Nakshatra, Lagna), this endpoint goes deeper, providing the full planetary and chart-level astrological data for both individuals that is needed for detailed compatibility analysis, dosha assessment, and the generation of rich matchmaking reports.
The API accepts complete birth date, time, and geographic coordinates for both individuals, computes their full Vedic birth charts using the specified Ayanamsha, and returns a comprehensive astrological profile for each person covering planetary positions, house placements, and all chart-derived attributes relevant to the matchmaking process.
What data it returns
- Full planetary position data for both individuals, including each planet's sign (Rashi), house, degree, nakshatra, and retrograde status
- Ascendant (Lagna) details for each individual, including the rising sign, degree, and Lagna lord
- House-wise planetary distribution for both charts, showing which planets occupy each of the twelve houses
- Nakshatra details for all planets, not just the Moon, providing a complete lunar mansion map of each individual's chart
- Planetary strength indicators and dignity status (exaltation, debilitation, own sign, etc.) for each planet in both charts
- Key chart-level attributes relevant to matchmaking, including Mangal (Mars) placement data for Mangal Dosha assessment
- Divisional chart data where applicable, supporting deeper compatibility analysis beyond the natal (Rashi) chart
- Localised output based on the requested language
Main use cases
- Comprehensive Kundali Milan analysis — Providing the full chart data for both individuals that powers detailed compatibility scoring, dosha analysis, and multi-layered matchmaking reports beyond basic Koota matching
- Mangal Dosha assessment — Supplying the precise Mars placement data for both individuals needed to evaluate Mangal Dosha presence and its implications for marital compatibility
- Marriage compatibility platforms — Serving as the primary chart data source for matrimonial and matchmaking applications that offer in-depth Vedic astrology-based compatibility analysis
- Side-by-side chart comparison — Enabling applications to display and compare the full birth charts of both individuals, highlighting planetary similarities, differences, and inter-chart dynamics
- Synastry and inter-chart analysis — Providing the planetary data needed to analyse how the planets of one individual's chart interact with the houses and planets of the other's chart
- Practitioner tools — Assisting astrologers in accessing complete dual-chart data in a single API call for efficient client consultations and matchmaking assessments
- Multi-step matchmaking workflows — Acting as the detailed chart data layer that feeds into compatibility scoring, report generation, and remedial guidance endpoints within the matchmaking suite
Key functionality
- Dual full-chart computation — Calculates and returns complete Vedic birth charts for both the male and female in a single request, covering all nine planets across all twelve houses for each individual
- Complete planetary detail — Returns each planet's sign, house, degree, Nakshatra, pada, dignity status, and retrograde condition for both charts, providing the full astrological picture needed for thorough compatibility analysis
- Mangal Dosha data — Includes precise Mars placement information for both individuals across the relevant houses, enabling accurate Mangal Dosha identification and severity assessment
- Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the
X-Ayanamsha header, ensuring sidereal chart calculations are 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 complement — Works in tandem with Match Birth Details and other matchmaking endpoints in the AstroInsight suite, providing the deeper chart data layer that enables comprehensive Kundali Milan analysis beyond the foundational birth identifiers
