Major Vimshottari Dasha API

Major Vimshottari Dasha

Returns the complete sequence of Major Dasha (Mahadasha) periods from the natal Vimshottari Dasha system — the most widely used planetary period system in Jyotish (Vedic astrology). The Vimshottari Dasha divides a person's life into a sequence of planetary periods spanning a total of 120 years, with each of the nine planets (Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury, Ketu, Venus) governing a major period of fixed duration. The Mahadasha sequence and its starting point are determined by the Moon's nakshatra at birth, making this endpoint the foundational timing layer for all natal predictive analysis.

What This API Does

This endpoint accepts an individual's birth details and computes the complete Vimshottari Mahadasha timeline anchored to their natal chart. It determines the Moon's nakshatra at birth and its balance (the remaining portion of the first dasha at the time of birth), then generates the full sequence of nine Mahadasha periods in their correct order from that entry point, each with its precise start and end dates spanning the individual's entire 120-year Vimshottari cycle. The endpoint provides not just the raw timeline but also contextual information about each dasha lord's natal chart condition, enabling practitioners to assess the quality and likely themes of each major life period.

Data Returned

The response provides the complete Vimshottari Mahadasha timeline and supporting data:

• Full Mahadasha sequence — the ordered list of all nine planetary Mahadasha periods in the correct Vimshottari sequence from the birth-determined entry point, covering the entire 120-year cycle

• Period start and end dates — precise calendar dates marking the beginning and end of each Mahadasha, enabling direct mapping of major life periods onto the calendar

• Period duration — the standard Vimshottari duration for each planet's Mahadasha (Sun 6 years, Moon 10 years, Mars 7 years, Rahu 18 years, Jupiter 16 years, Saturn 19 years, Mercury 17 years, Ketu 7 years, Venus 20 years)

• Dasha lord identity and natal position — the planet governing each Mahadasha, along with its zodiac sign, degree, house placement, nakshatra, and dignity in the natal chart

• Nakshatra reference — the natal Moon's nakshatra and its balance at birth, which determines the entry point into the Vimshottari sequence and the duration of the first (partial) Mahadasha

• Currently active Mahadasha — identification of which Mahadasha period is active at the time of the request, providing an immediate reference point within the full timeline

• Dasha lord condition indicators — assessments of each dasha lord's natal strength, house rulership, and functional nature (benefic/malefic) that inform the quality of its Mahadasha period

Main Use Cases

• Natal life timeline generation — computing the complete Mahadasha sequence as the primary temporal framework for a natal Jyotish reading, establishing the major life chapters and their approximate calendar windows

• Jyotish practitioners — accessing the full Mahadasha timeline as the foundational layer of predictive analysis, used to identify which planet governs the current and upcoming major life periods and assess their likely themes

• Astrology platforms and apps — powering life timeline features that display a person's Mahadasha sequence as a visual or tabular life map, showing past, current, and future major planetary periods

• Current period identification — quickly determining which Mahadasha a person is currently running, as a prerequisite for deeper analysis using sub-period (Antardasha) and sub-sub-period (Pratyantardasha) endpoints

• Life event correlation — mapping significant past life events onto the Mahadasha timeline to validate the dasha lord's themes and build confidence in the system before applying it to future predictions

• Long-range life planning — identifying upcoming Mahadasha periods and their governing planets to give clients a broad sense of the major themes and energies that will characterize different phases of their life

• Integration with transit and Varshaphal analysis — using the active Mahadasha lord as a reference point for interpreting transits and Varshaphal charts, since the dasha lord's condition significantly colors how other astrological influences manifest

Key Functionality

• Computes the complete 120-year Vimshottari Mahadasha sequence in a single response, covering all nine planetary periods from the birth-determined entry point through the full cycle, rather than returning only the current or near-term periods

• Determines the dasha entry point from the natal Moon's nakshatra and its precise balance at the moment of birth, ensuring the first Mahadasha's start date and duration are correctly calculated based on how much of that nakshatra had elapsed at birth

• Identifies the currently active Mahadasha at the time of the request, providing an immediate practical reference without requiring the caller to scan the full timeline

• Returns natal chart context for each dasha lord — including sign, house, dignity, and nakshatra — so the Mahadasha timeline is interpretively enriched rather than being a bare list of dates

• Accepts only birth details (date, time, and place of birth) with no current location required, since Mahadasha calculation is based entirely on the natal chart and is location-independent beyond the birth coordinates

• Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, since the Moon's nakshatra position — and therefore the entire dasha sequence — varies depending on the sidereal reference frame used

• Designed for localization — the Accept-Language header controls the language of planet names, nakshatra names, dignity labels, and all descriptive content in the response

• Serves as the top-level timing layer in a hierarchical dasha analysis, intended to be used as the entry point before drilling into Antardasha (sub-period) and Pratyantardasha (sub-sub-period) endpoints for finer-grained timing within each major period