SEARCH ASTRO INSIGHT API DOCS
The Major Vimshottari Dasha API provides Vimshottari Dasha related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/dasha/vimshottari/major-dasha
en
hi
ma
Methodology and astrological context for 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.
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.
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
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
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
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Major Vimshottari Dasha.
The Major Vimshottari Dasha API provides authentic Vimshottari Dasha calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Major Vimshottari Dasha API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Major Vimshottari Dasha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~48ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.