The Match Planet Details API returns a structured, planet-by-planet astrological breakdown for both individuals in a Kundali Milan (horoscope matching) workflow. Where the Match Astro Details endpoint provides the full chart picture, this endpoint delivers a focused planetary data set specifically organised for inter-chart comparison — making it the dedicated data source for compatibility tables, planetary position comparisons, and planet-level synastry analysis between the two individuals.
The API accepts complete birth date, time, and geographic coordinates for both the male and female, computes the planetary positions for each using the specified Ayanamsha, and returns a structured planet-wise profile for each individual that is optimised for side-by-side comparison and matchmaking analysis.
What data it returns
- A planet-by-planet listing for both individuals covering all nine Vedic planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu)
- For each planet in both charts: sign (Rashi), house position, degree, Nakshatra, pada, dignity status, and retrograde condition
- Comparative planetary data structured to facilitate direct planet-to-planet comparison between the male and female charts
- Inter-chart planetary relationship indicators, highlighting where the planets of one chart fall in relation to the houses and planets of the other
- Planetary lord details for each planet's sign and house placement, supporting deeper compatibility interpretation
- Specific planet placements relevant to matchmaking considerations, including Venus and Jupiter positions (significators of marriage and spouse) and Mars placement (for Mangal Dosha evaluation)
- Localised output based on the requested language
Main use cases
- Planetary compatibility tables — Powering side-by-side planet comparison tables in matchmaking reports and applications, showing both individuals' planetary positions in a structured, readable format
- Inter-chart synastry analysis — Providing the planet-level data needed to analyse how each planet in one individual's chart interacts with the houses and planets of the other's chart, revealing areas of harmony and tension
- Mangal Dosha evaluation — Supplying precise Mars placement data for both individuals to assess Mangal Dosha presence, severity, and mutual cancellation between the two charts
- Marriage significator analysis — Enabling focused analysis of Venus (significator of love and marriage for males) and Jupiter (significator of husband for females) placements in both charts for marital compatibility insights
- Kundali Milan report generation — Serving as the planet data source for the planetary section of comprehensive horoscope matching reports, where both charts' planetary positions are displayed and interpreted together
- Compatibility scoring inputs — Providing the structured planetary data that feeds into custom or extended compatibility scoring algorithms beyond the standard Ashtakoot system
- Practitioner and platform tools — Enabling astrologers and matchmaking platforms to access clean, comparison-ready planetary data for both individuals in a single API call
Key functionality
- Dual-chart planet-wise structure — Returns planetary data for both individuals in a format explicitly organised for comparison, making it straightforward to render side-by-side planetary tables or perform planet-to-planet analysis programmatically
- All nine planets covered — Includes data for all nine Vedic grahas (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) for each individual, ensuring complete chart coverage
- Marriage-relevant planet focus — Highlights the placements of Venus, Jupiter, and Mars with particular relevance to matchmaking, supporting Mangal Dosha checks and spouse significator analysis within the same response
- Inter-chart placement context — Provides data structured to support analysis of how one individual's planets fall across the other's chart houses, enabling synastry-style compatibility interpretation
- Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the
X-Ayanamsha header, ensuring sidereal planetary 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 integration — Designed as the planet-focused data layer within the AstroInsight matchmaking suite, complementing Match Birth Details and Match Astro Details to provide a complete, multi-level data foundation for Kundali Milan analysis
