Skip to main content

Vimshottari Dasha

Calculate the complete Vimshottari Dasha timeline for a birth chart. Returns Mahadasha, Antardasha, Pratyantar, Sookshma, and Prana periods up to 5 levels deep, with start and end dates for each. The starting planet is determined by the Moon's nakshatra at birth (Janma Nakshatra). Interpretation text accompanies the currently active Mahadasha and Antardasha.

Endpoint

POST /v1/astro/dasha

Request parameters

FieldTypeRequiredDescription
locationstring | nullNoCity name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
namestringNoPerson name associated with the birth record
datestringYesBirth date in YYYY-MM-DD format
timestring | nullNoBirth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudenumber | nullNoLatitude. Required if location not provided.
longitudenumber | nullNoLongitude. Required if location not provided.
timezonestring | nullNoIANA timezone. Required if location not provided.
ayanamsastringNoSidereal ayanamsa mode used in calculations
levelsintegerNoDepth of dasha hierarchy to compute (1 to 5)

Example request

curl -X POST "https://api.asterwise.com/v1/astro/dasha" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Example response

{
"success": true,
"message": "success",
"data": {
"periods": [
{
"planet": "Rahu",
"start_jd": 2446381.5520833335,
"end_jd": 2447279.642707222,
"start_date": "12/11/1985",
"end_date": "28/04/1988",
"sub": [
{
"planet": "Rahu",
"start_jd": 2446381.5520833335,
"end_jd": 2446516.2656769166,
"start_date": "12/11/1985",
"end_date": "26/03/1986",
"sub": null,
"modern_summary": "Rahu-Rahu swabhukti opens the 18-year Mahadasha with the planet operating at its most undiluted and amplified expression…"
},
{
"planet": "Jupiter",
"start_jd": 2446516.2656769166,
"end_jd": 2446636.011093435,
"start_date": "26/03/1986",
"end_date": "24/07/1986",
"sub": null,
"modern_summary": "Rahu-Jupiter is the most spiritually significant antardasha in the entire Rahu Mahadasha — nearly two and a half years w…"
},
"... and 7 more items"
],
"modern_summary": "Rahu Mahadasha extends for eighteen years — the longest shadow-node period in the Vimshottari sequence — and is among th…"
},
{
"planet": "Jupiter",
"start_jd": 2447279.642707222,
"end_jd": 2453123.744467222,
"start_date": "28/04/1988",
"end_date": "28/04/2004",
"sub": [
{
"planet": "Jupiter",
"start_jd": 2447279.642707222,
"end_jd": 2448058.8562752223,
"start_date": "28/04/1988",
"end_date": "16/06/1990",
"sub": null,
"modern_summary": "Jupiter-Jupiter swabhukti opens the 16-year Mahadasha with the planet operating in its purest and most undiluted express…"
},
{
"planet": "Saturn",
"start_jd": 2448058.8562752223,
"end_jd": 2448984.1723872223,
"start_date": "16/06/1990",
"end_date": "27/12/1992",
"sub": null,
"modern_summary": "Jupiter-Saturn is the wisdom-discipline combination — nearly two and a half years of the two great teachers operating to…"
},
"... and 7 more items"
],
"modern_summary": "Guru Mahadasha extends for sixteen years and is regarded in the classical tradition as the most broadly auspicious of al…"
},
"... and 16 more items"
],
"interpretation": {
"current_mahadasha": {
"planet": "Mercury",
"start_date": "29/04/2023",
"end_date": "28/04/2040",
"duration_years": 17,
"modern_summary": "Budha Mahadasha runs for seventeen years and brings the themes of Mercury to the center of the native's life — intellige…",
"favorable_conditions": [
"Exaltation (Virgo)",
"Own sign (Gemini or Virgo)",
"... and 4 more items"
],
"favorable_results": [
"Royal favor and high administrative recognition",
"Rise to positions of leadership",
"... and 6 more items"
],
"unfavorable_conditions": [
"Debilitation (Pisces)",
"Afflicted by malefics",
"... and 1 more item"
],
"unfavorable_results": [
"Mental anxiety and nervous strain",
"Communication breakdowns",
"... and 2 more items"
],
"timing_note": "Mercury placed in a Kendra or Trikona during its own Mahadasha tends to produce particularly strong and visible career a…",
"lagna_note": "Mercury rules the 9th and 12th houses for Libra ascendant — Trikona and dusthana lord creating a mixed role. Mercury Mah…"
},
"current_antardasha": {
"planet": "Ketu",
"mahadasha_planet": "Mercury",
"start_date": "24/09/2025",
"end_date": "21/09/2026",
"modern_summary": "Mercury-Ketu is a period of karmic reckoning within the intellectual Mahadasha — nearly twelve months where the analytic…",
"favorable_conditions": [
"Kendra, Trikona, or 11th house from Ascendant",
"Associated with benefic planets",
"... and 3 more items"
],
"favorable_results": [
"Physical well-being",
"Command of respect — avoiding insignificance",
"... and 1 more item"
],
"unfavorable_conditions": [
"8th or 12th house from Mahadasha lord",
"Association with malefic planets",
"... and 1 more item"
],
"unfavorable_results": [
"Falls from vehicles",
"Immense distress concerning children",
"... and 6 more items"
],
"timing_note": "",
"lagna_note": "Mercury rules the 9th and 12th houses for Libra ascendant — Trikona and dusthana lord creating a mixed role. Mercury Mah…"
}
},
"birth_time_provided": true
}
}

Response fields

FieldTypeDescription
successbooleanTrue if the request succeeded
messagestringHuman-readable status message
dataobject
data.periodsarray[object]Calculated Vimshottari dasha hierarchy
data.periods[].planetstringDasha lord for this period
data.periods[].start_jdnumberJulian day at period start
data.periods[].end_jdnumberJulian day at period end
data.periods[].start_datestringISO-like UTC date string for period start
data.periods[].end_datestringISO-like UTC date string for period end
data.periods[].subarray[DashaPeriod] | nullNested sub-periods for deeper hierarchy levels
data.periods[].modern_summarystring | nullOptional modern interpretation summary for this period
data.interpretationobject | nullStructured dasha interpretation summary
data.birth_time_providedbooleanWhether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors

CodeDescriptionReference
authentication_failedMissing or invalid API key.authentication_failed
ephemeris_unavailableUpstream ephemeris service error.ephemeris_unavailable
insufficient_tierAPI key tier does not include this endpoint.insufficient_tier
internal_errorUnexpected server error.internal_error
ip_rate_limit_exceededToo many requests in a short window.ip_rate_limit_exceeded
payload_too_largeRequest body exceeds the size limit.payload_too_large
resource_not_foundReferenced resource was not found.resource_not_found
validation_errorRequest body failed schema validation.validation_error