/v1/dasha/vimshottari

Full Vimshottari Dasha (5-level drill-down).

What this tells you

Vimshottari is the most important dasha system in Vedic astrology — a 120-year cycle of planetary periods driven by the Moon's nakshatra at birth. Each planet owns a fixed number of years. Every Mahadasha contains 9 Antardashas (in the same planetary order starting from the MD lord), each Antardasha contains 9 Pratyantar dashas, and so on down 5 levels. The deepest level (Praana dasha) is measured in minutes.

Depth: this endpoint returns 3 levels (MD → AD → PD) by default, with the first PD expanded to Sookshma and the first Sookshma expanded to Praana — so you can see the full depth structure. For specific deeper lookups, use /v1/dasha/vimshottari/current which returns the currently-active period at every level.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/dasha/vimshottari?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "system": "vimshottari",
  "birth_nakshatra": "Mrigashira",
  "start_lord": "Mars",
  "cycle_years": 120,
  "schedule": [
    {
      "level": "maha",
      "lord": "Mars",
      "start_jd": 2447773.0,
      "end_jd": 2450328.0,
      "start_date": "1989-09-03",
      "end_date": "1996-09-02",
      "duration_years": 7,
      "sub_periods": [
        {
          "level": "antar",
          "lord": "Mars",
          "start_date": "1989-09-03",
          "end_date": "1990-01-30",
          "duration_months": 4.9,
          "sub_periods": [
            {
              "level": "pratyantar",
              "lord": "Mars",
              "start_date": "1989-09-03",
              "end_date": "1989-09-12",
              "duration_days": 9.1,
              "sub_periods": [
                {
                  "level": "sookshma",
                  "lord": "Mars",
                  "start_date": "1989-09-03T00:00:00",
                  "end_date":   "1989-09-03T15:16:40",
                  "duration_hours": 15.3,
                  "sub_periods": [
                    { "level": "praana", "lord": "Mars",    "start_date": "1989-09-03T00:00:00", "end_date": "1989-09-03T00:53:20", "duration_minutes": 53.3 },
                    { "level": "praana", "lord": "Rahu",    "start_date": "1989-09-03T00:53:20", "end_date": "1989-09-03T03:13:20", "duration_minutes": 140 },
                    { "level": "praana", "lord": "Jupiter", "start_date": "1989-09-03T03:13:20", "end_date": "1989-09-03T05:20:00", "duration_minutes": 126.7 }
                  ]
                },
                { "level": "sookshma", "lord": "Rahu",    "start_date": "1989-09-03T15:16:40", "end_date": "1989-09-05T07:37:20", "duration_hours": 40.3, "sub_periods": [] },
                { "level": "sookshma", "lord": "Jupiter", "start_date": "1989-09-05T07:37:20", "end_date": "1989-09-06T22:01:20", "duration_hours": 38.4, "sub_periods": [] }
              ]
            },
            { "level": "pratyantar", "lord": "Rahu",    "start_date": "1989-09-12T00:00:00", "end_date": "1989-09-30T10:48:00", "duration_days": 26.4, "sub_periods": [] },
            { "level": "pratyantar", "lord": "Jupiter", "start_date": "1989-09-30T10:48:00", "end_date": "1989-10-22T13:20:00", "duration_days": 22.1, "sub_periods": [] }
          ]
        },
        { "level": "antar", "lord": "Rahu",    "start_date": "1990-01-30", "end_date": "1991-02-17", "duration_months": 12.6, "sub_periods": [] },
        { "level": "antar", "lord": "Jupiter", "start_date": "1991-02-17", "end_date": "1992-01-25", "duration_months": 11.2, "sub_periods": [] }
      ]
    },
    {
      "level": "maha",
      "lord": "Rahu",
      "start_date": "1996-09-02",
      "end_date": "2014-09-03",
      "duration_years": 18,
      "sub_periods": []
    },
    {
      "level": "maha",
      "lord": "Jupiter",
      "start_date": "2014-09-03",
      "end_date": "2030-09-03",
      "duration_years": 16,
      "sub_periods": []
    }
  ],
  "totals": {
    "Sun": 6, "Moon": 10, "Mars": 7, "Rahu": 18, "Jupiter": 16,
    "Saturn": 19, "Mercury": 17, "Ketu": 7, "Venus": 20
  }
}

Interactive preview

click any node to expand

Levels: Mahadasha → Antardasha → Pratyantar → Sookshma → Praana. Sample data.

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
system	string	Dasha system — always "vimshottari" for this endpoint. example: `"vimshottari"`
birth_nakshatra	string	Moon's nakshatra at birth. example: `"Mrigashira"`
start_lord	string	Lord of the Janma Nakshatra — drives the first Mahadasha. example: `"Mars"`
cycle_years	integer	Total cycle length. Always 120 for Vimshottari. example: `120`
schedule[]	array	Top-level Mahadasha (MD) periods. Each has nested sub_periods for deeper levels. example: `[…]`
schedule[].level	string	Level: "maha" (top) → "antar" → "pratyantar" → "sookshma" → "praana" (innermost). example: `"maha"`
schedule[].lord	string	Ruling planet for this period. example: `"Mars"`
schedule[].start_date, end_date	string (ISO)	Period boundaries in local calendar form. example: `"1989-09-03"`
schedule[].duration_years	number	Classical fixed durations: Sun 6, Moon 10, Mars 7, Rahu 18, Jupiter 16, Saturn 19, Mercury 17, Ketu 7, Venus 20. Sum = 120 years. example: `7`
schedule[].sub_periods[]	array	Recursive children. At each level, the same order repeats starting from the parent's lord. example: `[…]`
totals	object	Total years per planet in the Vimshottari cycle — for reference and validation. example: `…`

Usage tips

How to use it

Render as expandable tree
Start collapsed at MD level. On click, expand to show AD. Click AD, expand to PD. Most users never need beyond PD.
Highlight current period
Cross-reference with /v1/dasha/vimshottari/current to mark "you are here" at every level.
Durations halve each level
MD = years, AD = months, PD = weeks, SD = days, Praana = minutes. Frontend should format duration units per level.
Validation
Sum of MD durations = 120 years exactly. Sum of AD durations within a MD = parent MD's years. Use for client-side validation.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.