The Match Birth Details API computes and returns the core Vedic astrological birth details for two individuals — a male and a female — as the foundational step in a Kundali Milan (horoscope matching) workflow. In Vedic astrology, marriage compatibility analysis begins with deriving each person's key astrological identifiers from their birth data: their Rashi (Moon sign), Nakshatra (lunar mansion), Ascendant (Lagna), and related chart parameters. This endpoint performs those calculations for both individuals simultaneously, providing the essential astrological profile data that underpins all subsequent matchmaking analysis.
The API accepts complete birth date, time, and geographic coordinates for both the male and female, calculates their respective astrological birth details using the specified Ayanamsha, and returns a structured profile for each individual ready for use in compatibility scoring and report generation.
What data it returns
- For each individual (male and female): their computed Rashi (Moon sign), Janma Nakshatra (birth lunar mansion), Nakshatra pada, and Ascendant (Lagna) sign
- Nakshatra lord and Rashi lord for each individual, establishing the planetary rulers governing their core astrological identity
- Charan (pada) details of the Janma Nakshatra, providing the granular lunar mansion subdivision used in compatibility calculations
- Moon's degree and sign position for each individual, which forms the basis of Ashtakoot and other matching systems
- Additional birth chart identifiers relevant to the matchmaking process, such as Gana (temperament group), Varna (spiritual class), Yoni (instinctive nature), and Nadi (energy channel) — the key Koota attributes derived from the Nakshatra
- Localised output based on the requested language
Main use cases
- Kundali Milan initiation — Serving as the first API call in a horoscope matching workflow, establishing the astrological birth profiles of both individuals before compatibility scoring endpoints are invoked
- Marriage compatibility platforms — Powering the birth detail computation layer of matrimonial and matchmaking applications that offer Vedic astrology-based compatibility analysis
- Astrological profile generation — Providing a quick, dual-individual birth detail lookup for practitioners or platforms that need both partners' core astrological identifiers in a single request
- Koota-based matching preparation — Supplying the Nakshatra-derived Koota attributes (Gana, Varna, Yoni, Nadi, etc.) needed as inputs for Ashtakoot or Dashakoot compatibility scoring
- Compatibility report enrichment — Embedding individual birth detail summaries as introductory sections within comprehensive Kundali Milan reports, contextualising the match analysis for end users
- Multi-step matchmaking workflows — Acting as the data-gathering step that feeds into subsequent match-making endpoints for detailed compatibility scores, dosha analysis, and remedial guidance
Key functionality
- Dual-individual calculation — Accepts and processes birth data for both the male and female in a single request, computing each person's full astrological birth profile simultaneously and returning both in one response
- Nakshatra and Koota attribute derivation — Computes not just the Nakshatra but also the Koota attributes (Gana, Varna, Yoni, Nadi, and others) directly from the Nakshatra, providing all the building blocks needed for Ashtakoot compatibility scoring
- Ascendant and Moon sign precision — Calculates both the Lagna and the Moon's Rashi and degree position with geographic and timezone accuracy, ensuring the birth profiles are correctly grounded in each individual's local birth coordinates
- Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the
X-Ayanamsha header, ensuring sidereal calculations are aligned with the preferred Jyotish tradition
- Geographic precision — Accepts separate latitude, longitude, and timezone values for each individual, correctly handling cases where the two individuals were born in different locations or 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 entry point — Designed as the foundational endpoint of the AstroInsight matchmaking suite, with its output serving as the input context for compatibility scoring, Mangal Dosha analysis, and other match-making endpoints
