POST/v1/astro/dasha

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). The first Mahadasha row starts at birth and lasts the balance; its sub-periods are the remaining tail of the full Mahadasha, which began before birth, so the period running at birth is usually not the Mahadasha lord's own. That row also gives dasha_start_date and balance_years. Dates are DD/MM/YYYY. Interpretation text accompanies the currently active Mahadasha and Antardasha.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetoptional

string | null

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

levelsoptional

integer

Depth of dasha hierarchy to compute (1 to 5)

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.periods

array[object]

Calculated Vimshottari dasha hierarchy

data.periods[].planet

string

Dasha lord for this period

data.periods[].start_jd

number

Julian day at period start

data.periods[].end_jd

number

Julian day at period end

data.periods[].start_date

string

Period start, DD/MM/YYYY (UTC calendar date). The first Mahadasha row starts at birth.

data.periods[].end_date

string

Period end, DD/MM/YYYY (UTC calendar date)

data.periods[].sub

array[DashaPeriod] | null

Nested sub-periods for deeper hierarchy levels. Under the first Mahadasha these are the remaining tail of the full Mahadasha, which began before birth: periods that ended before birth are omitted and the one running at birth starts at birth.

data.periods[].dasha_start_date

string | null

Only on the first Mahadasha row: the date (DD/MM/YYYY, UTC) the full Mahadasha began, before birth. The row itself starts at birth and lasts the balance.

data.periods[].balance_years

number | null

Only on the first Mahadasha row: the balance of that Mahadasha remaining at birth, in years of 365.25636 days.

data.periods[].modern_summary

string | null

Optional modern interpretation summary for this period

data.interpretation

object | null

Structured dasha interpretation summary

data.birth_time_provided

boolean

Whether 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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Ashtottari Dasha
• Jaimini Char Dasha
• Dasha-Transit Correlation
• Yogini Dasha

Request

POST·application/json

curl

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"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.dasha_request import DashaRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = DashaRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.dasha(dasha_request=request)
    print(result)

TypeScript

import { createClient, createConfig, dasha } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await dasha({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "periods": [
      {
        "planet": "Rahu",
        "start_jd": 2446381.5520877494,
        "end_jd": 2447277.93604306,
        "start_date": "12/11/1985",
        "end_date": "26/04/1988",
        "sub": [
          {
            "planet": "Moon",
            "start_jd": 2446381.5520877494,
            "end_jd": 2446894.4168650596,
            "start_date": "12/11/1985",
            "end_date": "08/04/1987",
            "sub": null,
            "dasha_start_date": null,
            "balance_years": null,
            "modern_summary": "Rahu-Moon is the most psychologically vulnerable antardasha in the entire Rahu Mahadasha — eighteen months where Rahu's…"
          },
          {
            "planet": "Mars",
            "start_jd": 2446894.4168650596,
            "end_jd": 2447277.93604306,
            "start_date": "08/04/1987",
            "end_date": "26/04/1988",
            "sub": null,
            "dasha_start_date": null,
            "balance_years": null,
            "modern_summary": "Rahu-Mars closes the 18-year Rahu Mahadasha with twelve months of the two most volatile and forceful planetary energies…"
          }
        ],
        "dasha_start_date": "26/04/1970",
        "balance_years": 2.454122784639331,
        "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": 2447277.93604306,
        "end_jd": 2453122.03780306,
        "start_date": "26/04/1988",
        "end_date": "26/04/2004",
        "sub": [
          {
            "planet": "Jupiter",
            "start_jd": 2447277.93604306,
            "end_jd": 2448057.14961106,
            "start_date": "26/04/1988",
            "end_date": "14/06/1990",
            "sub": null,
            "dasha_start_date": null,
            "balance_years": 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": 2448057.14961106,
            "end_jd": 2448982.46572306,
            "start_date": "14/06/1990",
            "end_date": "25/12/1992",
            "sub": null,
            "dasha_start_date": null,
            "balance_years": 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"
        ],
        "dasha_start_date": null,
        "balance_years": null,
        "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": "27/04/2023",
        "end_date": "26/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; the 9th lordship makes Mercury a…"
      },
      "current_antardasha": {
        "planet": "Venus",
        "mahadasha_planet": "Mercury",
        "start_date": "20/09/2026",
        "end_date": "21/07/2029",
        "modern_summary": "Mercury-Venus is the longest antardasha in the Mercury Mahadasha at nearly three years — and when Venus is strong, it is…",
        "favorable_conditions": [
          "Exaltation or own sign",
          "Kendra or Trikona",
          "... and 1 more item"
        ],
        "favorable_results": [
          "Supreme material and intellectual synthesis",
          "Beautiful garments and luxury vehicles",
          "... and 3 more items"
        ],
        "unfavorable_conditions": [
          "Debilitation",
          "6th, 8th, or 12th house"
        ],
        "unfavorable_results": [
          "Scandals",
          "Disputes with women",
          "... and 2 more items"
        ],
        "timing_note": "",
        "lagna_note": "Mercury rules the 9th and 12th houses for Libra ascendant — Trikona and dusthana lord; the 9th lordship makes Mercury a…"
      }
    },
    "birth_time_provided": true
  }
}