Birth Details
Computes the core Vedic astrological birth chart details for a person from their birth date, time, and geographic coordinates — returning the foundational planetary and house data that underpins all subsequent Vedic astrology calculations, interpretations, and report generation.
What this API does
The Birth Details endpoint is the primary entry point for Vedic birth chart computation. Given a person's name, date and time of birth, timezone offset, and geographic coordinates, it calculates the complete set of fundamental astrological data points that define the native's Vedic birth chart (Janma Kundali).
This includes computing the precise sidereal positions of all planets using the selected ayanamsha, determining the Ascendant (Lagna) and all twelve house cusps, identifying the Nakshatra (lunar mansion), Pada, Rashi (Moon sign), and Tithi at the time of birth, and deriving the Vimshottari Dasha sequence from the Moon's Nakshatra position. The result is a comprehensive, structured birth chart data object that serves as the foundation for all further astrological analysis — from dosha detection and Ashtakavarga to compatibility matching and predictive timing.
What data it returns
The API returns a structured JSON response including:
- Planetary positions: The sidereal longitude, sign (Rashi), house placement, Nakshatra, Pada, and retrograde status for each of the classical planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn) as well as Rahu and Ketu
- Ascendant (Lagna): The rising sign, its degree, and the Nakshatra on the Ascendant
- House cusps: The sign and degree of each of the twelve house cusps in the selected house system
- Nakshatra details: The birth Nakshatra (Janma Nakshatra), its lord, Pada, and associated qualities
- Rashi (Moon sign): The sign occupied by the Moon at birth, along with its lord and characteristics
- Tithi: The lunar day at the time of birth, including its name, type, and deity
- Vimshottari Dasha sequence: The complete lifetime dasha timeline derived from the Moon's Nakshatra position, including the current dasha, antardasha, and pratyantardasha with start and end dates
- Basic chart summary: Key chart identifiers such as the native's name, birth details, and a summary of the chart's most significant placements
Main use cases
- Birth chart generation as the foundational step in any Vedic astrology application — this endpoint provides all the raw chart data needed to render a Kundali, populate a chart wheel, or display a planetary positions table
- Dasha timeline computation for astrology platforms that display the native's complete Vimshottari Dasha sequence, current period, and upcoming period transitions
- Nakshatra and Rashi identification for applications that provide birth star reports, Nakshatra-based compatibility, or Moon sign horoscopes
- Data sourcing for downstream calculations — the planetary positions and house placements returned by this endpoint serve as the input basis for all other astrological computations in the API suite, including dosha analysis, Ashtakavarga, Shadbala, divisional charts, and compatibility matching
- Onboarding and profile creation in astrology apps where a user's birth details are entered once and the resulting chart data is stored and reused across all features
- Horoscope report generation that requires a complete, structured birth chart data object as the starting point for generating personalized astrological reports
- Educational astrology platforms that teach Vedic chart reading by displaying the full set of birth chart data points alongside explanations of each element
Key functionality
- Complete birth chart in a single request: Computes all fundamental Vedic birth chart data points — planetary positions, house cusps, Ascendant, Nakshatra, Tithi, and Dasha sequence — in one API call, providing everything needed to begin astrological analysis.
- Sidereal planetary computation: Calculates all planetary positions using the Vedic sidereal zodiac, correctly accounting for the ayanamsha offset from the tropical zodiac to produce accurate Vedic chart placements.
- Ayanamsha selection: The
X-Ayanamsha header allows selection of the sidereal calculation system (e.g., Lahiri, Raman, KP), ensuring the chart is computed according to the practitioner's or platform's preferred Vedic tradition.
- Vimshottari Dasha timeline: Derives the complete lifetime Vimshottari Dasha sequence from the Moon's Nakshatra position and balance at birth, including all major, sub, and sub-sub periods with precise start and end dates.
- Nakshatra and Pada precision: Identifies the exact Nakshatra and Pada for the Moon and all other planets, enabling Nakshatra-level analysis across the entire chart.
- Name inclusion: Accepts the native's name as part of the request, allowing the response to be personalized and directly used in report generation without additional data mapping.
- Geographic coordinate support: Uses latitude and longitude for precise Ascendant and house cusp calculation, ensuring accuracy for birth locations anywhere in the world.
- Multilingual support: The
Accept-Language header enables localized planet names, sign names, Nakshatra names, and interpretive descriptions, making the API suitable for a global, multilingual user base.
