Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology

Match Planet Details Extended API

The Match Planet Details Extended API delivers enhanced planetary compatibility analysis with detailed astrological calculations for advanced matchmaking systems.

The Match Planet Details Extended API returns an enriched, extended planetary data set for both individuals in a Kundali Milan (horoscope matching) workflow. It is the comprehensive superset of the Match Planet Details endpoint, augmenting the standard planet-by-planet positional data with deeper astrological attributes — including planetary strength indicators, divisional chart positions, special planetary conditions, and additional compatibility-relevant metrics — that are required for the most thorough and nuanced matchmaking analysis.

The API accepts complete birth date, time, and geographic coordinates for both the male and female, computes their full extended planetary profiles using the specified Ayanamsha, and returns a richly detailed, comparison-ready planetary data set for each individual.


What data it returns

  • All planetary data returned by Match Planet Details (sign, house, degree, Nakshatra, pada, dignity status, retrograde condition) for all nine Vedic planets across both charts
  • Extended planetary strength data, including Shadbala (six-fold strength) scores or equivalent strength indicators for each planet in both charts
  • Divisional chart (Varga) positions for each planet, covering key divisional charts relevant to matchmaking such as the Navamsha (D9) — the primary chart for marriage and partnership analysis
  • Special planetary conditions and states, such as combustion (Asta), war between planets (Graha Yuddha), planetary maturity (Vargottama), and other dignified or afflicted states
  • Nakshatra-level extended attributes for each planet, including Nakshatra lord, sub-lord, and sub-sub-lord where applicable (as used in KP astrology)
  • Additional compatibility-relevant planetary indicators that go beyond standard positional data, providing the depth needed for advanced matchmaking scoring and report generation
  • Localised output based on the requested language

Main use cases

  • Advanced Kundali Milan analysis — Powering the most comprehensive horoscope matching workflows that require planetary strength, Navamsha positions, and special conditions in addition to standard positional data
  • Navamsha-based compatibility — Providing Navamsha (D9) chart planetary positions for both individuals, enabling marriage chart analysis that is central to deep Vedic compatibility assessment
  • Planetary strength comparison — Enabling side-by-side comparison of planetary strength scores between the two charts to assess which individual's planets are stronger in key areas relevant to marital life
  • KP astrology matchmaking — Supporting Krishnamurti Paddhati (KP) based compatibility analysis through sub-lord and sub-sub-lord data, catering to practitioners and platforms that use the KP system
  • Premium matchmaking reports — Serving as the data backbone for premium or professional-grade Kundali Milan reports that include divisional chart analysis, strength comparisons, and special planetary condition assessments
  • Combustion and affliction analysis — Identifying combusted, debilitated, or otherwise afflicted planets in both charts that may have specific implications for marital harmony and life outcomes
  • Research and advanced practitioner tools — Providing the full depth of planetary data needed by experienced astrologers and research-oriented platforms for detailed, multi-layered compatibility studies

Key functionality

  • Extended planetary attribute set — Returns a significantly richer planetary profile than Match Planet Details, adding strength scores, divisional positions, and special conditions that are essential for advanced matchmaking analysis
  • Navamsha (D9) chart integration — Includes Navamsha positions for all planets in both charts, making this the go-to endpoint for any matchmaking workflow that incorporates the marriage divisional chart
  • Shadbala and strength indicators — Provides planetary strength data for both charts, enabling quantitative comparison of planetary power across the two individuals in areas such as career, health, and relationship significations
  • Special planetary state detection — Identifies and flags significant planetary conditions (combustion, Vargottama, Graha Yuddha, etc.) in both charts, adding a layer of qualitative depth to the planetary comparison
  • KP sub-lord data — Includes Nakshatra sub-lord and sub-sub-lord details where applicable, supporting KP-based matchmaking analysis alongside traditional Parashari methods
  • Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring all 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 apex endpoint — Serves as the most data-rich planetary endpoint in the AstroInsight matchmaking suite, designed for use cases that demand the full depth of planetary information beyond what Match Planet Details provides, while maintaining the same dual-individual, comparison-ready structure
Credit Cost
1 Credits/Per API Call
Avg Response
~68msTypical Latency

Supported Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

🌐 API responses available in 3 regional languages. Pass Accept-Languageparameter in request header with language code.

API Explorer

POST https://json.astroinsightapi.com/api/v1/match-making/planet-details/extended

Request Example:

HTTP Status Codes

API Categories