Timing
Vimshottari and Yogini Dasha API
Our dasha API turns a birth date, time and place into a timeline of planetary periods (dashas). You get the start and end date of every period in the Vimshottari system, down to five levels. Yogini dasha, a shorter 36-year system, comes from the same chart.
POST /v1/dasha/vimshottari200 OK{
"system": "vimshottari",
"periods": [
{
"lord": "Mars",
"start": "1989-12-20T08:04:30.831945",
"end": "1996-12-20T02:04:30.831945"
},
{
"lord": "Rahu",
"start": "1996-12-20T02:04:30.831945",
"end": "2014-12-20T14:04:30.831945"
},
{
"lord": "Jupiter",
"start": "2014-12-20T14:04:30.831945",
"end": "2030-12-20T14:04:30.831945"
}
]
}What the dasha API returns
- Vimshottari: the nine main periods (mahadashas) of the 120-year cycle, each with its ruling planet and its start and end dates.
- The sub-periods inside each one: antardasha, then pratyantardasha, and down to five levels with levels=1 to 5. The default is three levels.
- The balance at birth: how much of the first period was left when the person was born. The first period is listed at full length, so it starts before birth.
- Sub-periods that ended before birth are marked elapsed, so you can hide them.
- Yogini: eight periods that add up to 36 years, each with its yogini, its ruling planet, its dates and one level of sub-periods.
- Every date is in the local time of the birth place, ready for a timeline or a "current period" screen.
Both systems start from the same Moon position, so they never disagree about where the timeline begins. They come side by side, and neither one overrides the other. To say what a period means in words, use the readings endpoints.
The rules behind it
Vimshottari has nine periods in a fixed order that add up to 120 years (DA-01). The first period belongs to the lord of the nakshatra the Moon was in at birth (DA-02). How far the Moon had moved through that nakshatra tells how much of the first period was already used up (DA-03). Each period splits into sub-periods in the same order, starting with its own lord (DA-04). Yogini has eight periods over 36 years (YD-01), and it stops at two levels, because a third would last only days (YD-04). Both systems use a year of 365.25 days (YD-03), and neither overrules the other (YD-05).
Browse the full rulebookTerms used here
Who uses it
Astrology API
Call it with a free test key
Create an account and a test key, then call any endpoint on this page. Or try a request in the API reference first.
01
A free test key, with 1,000 requests a month
02
Try any endpoint in your browser first
03
Every rule published, so you can check any answer