Back to Docs

Vimshottari Dasha

POST/api/v1/vedic/dasha

Calculate the complete Vimshottari Dasha timeline (120-year cycle) based on Moon's Nakshatra at birth. Returns Mahadasha periods with optional Antardasha and Pratyantar sub-periods.

Full URL

https://astro-api-1qnc.onrender.com/api/v1/vedic/dasha

Request Parameters

ParameterTypeRequiredDescription
yearintegerYesYear of birth (e.g., 1990)
monthintegerYesMonth of birth (1-12)
dayintegerYesDay of birth (1-31)
hourintegerYesHour of birth (0-23)
minuteintegerYesMinute of birth (0-59)
latfloatYesLatitude of birth location (-90 to 90)
lngfloatYesLongitude of birth location (-180 to 180)
citystringNoCity name (for display purposes)
tz_strstringNoTimezone string (e.g., 'Asia/Kolkata'). Use 'AUTO' for automatic detection.
ayanamshastringNoAyanamsha system: 'lahiri' (default), 'raman', 'krishnamurti'
house_systemstringNoHouse system: 'whole_sign' (default), 'placidus', 'equal'
node_typestringNoLunar node type: 'mean' (default) or 'true'
levelsintegerNoDasha depth: 1 (Mahadasha only), 2 (+ Antardasha), 3 (+ Pratyantar). Default: 2

Understanding Dasha Levels

Level 1
Mahadasha Only

Returns only the 9 major periods (120-year cycle). Fastest response.

Level 2
+ Antardasha

Includes sub-periods within each Mahadasha. Recommended for most use cases.

Level 3
+ Pratyantar

Full granularity with third-level sub-periods. Large response, use sparingly.

Sample Code

import requests
import json

url = "https://astro-api-1qnc.onrender.com/api/v1/vedic/dasha"

payload = {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 30,
    "city": "New Delhi",
    "lat": 28.6139,
    "lng": 77.2090,
    "tz_str": "Asia/Kolkata",
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean",
    "levels": 2  # Mahadasha + Antardasha
}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response Data

{
  "vimshottari_dasha": [
    {
      "lord": "Moon",
      "start": "1985-04-12",
      "end": "1995-04-12",
      "duration_years": 10,
      "sub_periods": [
        {
          "lord": "Moon",
          "start": "1985-04-12",
          "end": "1986-02-12",
          "duration_months": 10
        },
        {
          "lord": "Mars",
          "start": "1986-02-12",
          "end": "1986-09-12",
          "duration_months": 7
        },
        {
          "lord": "Rahu",
          "start": "1986-09-12",
          "end": "1988-03-12",
          "duration_months": 18
        }
        // ... more sub-periods
      ]
    },
    {
      "lord": "Mars",
      "start": "1995-04-12",
      "end": "2002-04-12",
      "duration_years": 7,
      "sub_periods": [...]
    },
    {
      "lord": "Rahu",
      "start": "2002-04-12",
      "end": "2020-04-12",
      "duration_years": 18,
      "sub_periods": [...]
    }
    // ... continues for 120 years
  ],
  "current_dasha": {
    "mahadasha": "Rahu",
    "antardasha": "Venus",
    "start_date": "2018-06-15",
    "end_date": "2021-06-15"
  },
  "metadata": {
    "ayanamsha": "lahiri",
    "moon_nakshatra": "Shatabhisha",
    "balance_at_birth": {
      "lord": "Moon",
      "years": 5,
      "months": 3,
      "days": 12
    }
  }
}

Related Endpoints