Vimshottari Dasha¶

There are two Vimshottari surfaces. The /dashas/vimshottari (plural) V2 family is the current one — it adds the fourth Sukshmadasha level, per-lord strength/dignity context, and frontend-ready timeline cards. The original /dasha/vimshottari (singular) endpoints below remain as a lighter, three-level legacy alias. Prefer the V2 family for new integrations.

V2 — `GET /v1/vedic/charts/{chart_id}/dashas/vimshottari`¶

The full MD/AD/PD/SD chain from the natal Moon, each period annotated with its lord's strength, house, dignity, and nakshatra context.

{
  "chart_id": "01HKD…",
  "method": "vimshottari",
  "method_version": "v2",
  "birth_dasha_lord": "moon",
  "birth_dasha_start": "1985-03-15T12:00:00Z",
  "mahadashas": [
    {
      "period_level": "maha", "level": 1, "lord": "moon", "parents": [],
      "starts_at": "1985-03-15T12:00:00Z", "ends_at": "1995-03-13T12:00:00Z",
      "duration_days": 3650.0, "lord_strength": 0.62, "lord_house": 4,
      "owned_houses": [4], "dignity": "own_sign",
      "lord_context": {
        "lord": "moon", "lord_strength": 0.62, "lord_house": 4,
        "owned_houses": [4], "dignity": "own_sign", "sign": "cancer",
        "nakshatra": "pushya"
      }
    }
  ],
  "antardashas": [ "…" ],
  "pratyantardashas": [ "…" ],
  "sukshmadashas": [ "…" ],
  "features_used": [ { "source": "vimshottari", "version": "v2", "fields": ["lord_context"] } ]
}

Field (per period)	Type	Notes
`period_level`	string	`maha` / `antar` / `pratyantar` / `sukshma`.
`level`	int	1–4.
`lord`	string	Period-ruling planet.
`parents`	string[]	The enclosing lords, outermost first.
`starts_at` / `ends_at`	ISO 8601	Period bounds.
`duration_days`	float
`lord_strength`	float \| null	Normalised strength of the lord.
`lord_house`	int \| null	House the lord occupies.
`owned_houses`	int[]	Houses the lord rules.
`dignity`	string \| null	Lord's dignity.
`lord_context`	object	`{lord, lord_strength, lord_house, owned_houses, dignity, sign, nakshatra}`.

`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/current?at=<iso>`¶

The MD / AD / PD / SD active at a moment (tz-aware). Returns {chart_id, at, md, ad, pd, sd, features_used} — each of md/ad/pd/sd is a period object as above, or null if at falls outside the chain.

`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/next-change?at=<iso>`¶

The next period boundary at or after at:

{
  "chart_id": "01HKD…", "at": "2026-06-05T00:00:00Z",
  "changes_at": "2026-09-12T04:31:00Z", "changed_level": "pratyantar",
  "current_period": { "…": "period object" },
  "next_period": { "…": "period object" },
  "features_used": []
}

`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/cards?starts_at=<iso>&ends_at=<iso>`¶

Frontend-ready timeline cards for the [starts_at, ends_at) window — one card per dasha period overlapping the range:

{
  "chart_id": "01HKD…",
  "starts_at": "2026-01-01T00:00:00Z", "ends_at": "2027-01-01T00:00:00Z",
  "cards": [
    {
      "kind": "dasha_period", "title": "Saturn–Venus", "starts_at": "…", "ends_at": "…",
      "period": { "…": "period object" }, "signals": ["lord_in_own_sign"]
    }
  ],
  "features_used": []
}

Legacy — `GET /v1/vedic/charts/{id}/dasha/vimshottari`¶

Returns the full 120-year Vimshottari chain from birth: - 9 Mahadashas (MD) — top-level periods, each 6-20 years per the classical years-per-planet allocation. - 81 Antardashas (AD) — sub-periods. - 729 Pratyantardashas (PD) — sub-sub-periods.

{
  "birth_dasha_lord": "moon",
  "birth_dasha_start": "1985-03-15T12:00:00Z",
  "mahadashas": [
    {"lord": "moon", "parents": [], "start": "1985-03-15T12:00:00Z", "end": "1995-03-13T12:00:00Z", "level": 1},
    {"lord": "mars", "parents": [], "start": "1995-03-13T12:00:00Z", "end": "2002-03-12T12:00:00Z", "level": 1},
    "…"
  ],
  "antardashas": ["…81 entries"],
  "pratyantardashas": ["…729 entries"]
}

The 9-planet cycle (Ketu 7y, Venus 20y, Sun 6y, Moon 10y, Mars 7y, Rahu 18y, Jupiter 16y, Saturn 19y, Mercury 17y) sums to exactly 120 years.

`GET /v1/vedic/charts/{id}/dasha/current?at=<iso>`¶

Looks up the MD / AD / PD active at any moment (must be tz-aware).

{
  "md": {"lord": "saturn", "start": "…", "end": "…", "level": 1},
  "ad": {"lord": "venus", "parents": ["saturn"], "start": "…", "end": "…", "level": 2},
  "pd": {"lord": "mercury", "parents": ["saturn", "venus"], "start": "…", "end": "…", "level": 3}
}

Each level is null if at is outside the 120-year chain.

Alternative dashas¶

Beyond the headline Vimshottari, two more classical dasha systems are exposed.

`GET /v1/vedic/charts/{id}/dasha/yogini`¶

8-yogini Vimshottari alternative on a 36-year cycle. Each yogini is paired with a planet and a fixed duration:

#	Yogini	Lord	Years
1	Mangala	Moon	1
2	Pingala	Sun	2
3	Dhanya	Jupiter	3
4	Bhramari	Mars	4
5	Bhadrika	Mercury	5
6	Ulka	Saturn	6
7	Siddha	Venus	7
8	Sankata	Rahu	8

The starting yogini is determined by the janma nakshatra: (nakshatra_index + 3) mod 8. The ring then walks chronologically in fixed order, emitting periods until total_years (default 72) are covered.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/dasha/yogini"

{
  "chart_id": "01HKD…",
  "birth_nakshatra": "Anuradha",
  "starting_yogini_index": 3,
  "periods": [
    {"yogini_name": "Bhramari", "lord": "mars", "years": 4,
     "start": "1990-06-15T09:30:00+00:00",
     "end": "1994-06-14T21:13:00+00:00"},
    "…"
  ]
}

`GET /v1/vedic/charts/{id}/dasha/chara`¶

Jaimini Chara dasha — sign-based, not planet-based. Walks the 12 signs in zodiacal order from the natal lagna. Each sign's duration = count from the dasha sign to its lord's natal sign (zodiacal direction). 12 years if the lord sits in its own sign. The full cycle covers ~78 years.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/dasha/chara"

{
  "chart_id": "01HKD…",
  "starting_sign": "aries",
  "periods": [
    {"sign": "aries", "sign_lord": "mars", "years": 7,
     "start": "1990-06-15T09:30:00+00:00",
     "end": "1997-06-13T15:09:00+00:00"},
    {"sign": "taurus", "sign_lord": "venus", "years": 3,
     "start": "1997-06-13T15:09:00+00:00",
     "end": "2000-06-12T13:09:00+00:00"},
    "…"
  ]
}

When to use which¶

Vimshottari — the default Indian dasha framework; almost every prediction baseline uses it.
Yogini — 36-year cycle, useful for medium-horizon timing where Vimshottari's MD is too coarse.
Chara — sign-based, useful when the focus is the house under emphasis rather than the planet.

Vimshottari Dasha¶

V2 — GET /v1/vedic/charts/{chart_id}/dashas/vimshottari¶

GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/current?at=<iso>¶

GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/next-change?at=<iso>¶

GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/cards?starts_at=<iso>&ends_at=<iso>¶

Legacy — GET /v1/vedic/charts/{id}/dasha/vimshottari¶

GET /v1/vedic/charts/{id}/dasha/current?at=<iso>¶