New Numerology API
Docs menu
Download

Dasha API reference

Updated

The dasha endpoints of API for Astrology (apiforastrology.com) turn birth details into timelines of planetary periods. You get Vimshottari, Yogini, Ashtottari and Narayana, each period with its start and end date. Vimshottari, the main system, splits a 120-year cycle into nine periods. Narayana, a Jaimini system, runs its periods by signs, not planets. The group has 4 endpoints.

Call POST /v1/dasha/vimshottari for the main timeline. John Doe's timeline starts in a Mars period. The Moon's nakshatra (birth star) at birth picks the first period, and the Moon moves fast. So the birth time matters here. The ayanamsa matters too: a different one shifts every later date, as the ayanamsa guide shows. Yogini and Ashtottari start from the same Moon. How Vimshottari dasha is calculated walks through the math step by step. Always send hour and minute: they are optional, and they default to 0 (midnight).

Dashas are planetary periods: a life is divided into periods, each ruled by one planet. Vimshottari is a 120-year cycle, returned with up to five levels of sub-periods and calendar dates. Yogini is a second system of 36 years. Ashtottari is a third, of 108 years, with a test of whether it applies to the chart. Narayana is a Jaimini dasha whose periods are run by signs, not planets.

4 endpoints. Paths are relative to https://apiforastrology.com/api/astrology. Send your API key in the Authorization: Bearer header (see authentication). No key yet? Get a key. To send test requests from the browser, open the interactive reference.

Overview: Dashas (planetary periods), Jaimini astrology.

Which dasha endpoint to call

What you needEndpointCost
The main dasha timeline, with dates. Start herePOST /v1/dasha/vimshottari1 call
A second, shorter system: eight periods in 36 yearsPOST /v1/dasha/yogini1 call
The 108-year system, with a check of whether it applies to the chartPOST /v1/dasha/ashtottari1 call
The Jaimini system: each period is run by a sign, with a reading of eachPOST /v1/dasha/narayana1 call

Vimshottari dasha periods with dates

POST /v1/dasha/vimshottari

Returns the Vimshottari dasha timeline. Dashas are planetary periods. Vimshottari divides a 120-year cycle into nine periods, each ruled by one planet. The starting point comes from the Moon's nakshatra (one of 27 lunar mansions) at birth. Each period divides into sub-periods, down to five levels.

Set levels in the request body. 1 gives the main periods (mahadasha) and 2 adds sub-periods (antardasha). 3 adds the next level (pratyantardasha), and so on up to 5. The default is 3.

Every period has start and end dates in the local time of the birth place. The first main period is listed at its full length, so it starts before birth; balance_at_birth_years gives the part that remained at birth.

The balance is measured by time. How much of the first period was over at birth comes from how long the Moon had been in its birth nakshatra, out of the whole time it takes to cross it (bhayat over bhabhog). This is the classical method. Measuring by distance instead is the common software shortcut, and the two can differ by days, up to about a month. balance_conventions gives both, with the end of the first period under each and shift_days between them. Set dasha_balance to longitude to build every date on the distance balance. See rulebook DA-03.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (9), with their defaults
NameInWhat it does
langqueryLanguage for the names in the response, such as planets, signs, nakshatras (lunar mansions), tithis (lunar days), months and festivals. The default is en (English); GET /v1/meta lists the others. Each translated value comes with its English original in a matching <field>_en field; use the English value as a key in your code. Codes (such as result or kaal) and object keys always stay in English. Any name not yet translated stays in English and is listed in localization.untranslated.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.
dasha_balancebodyHow much of the first period was over at birth. time (the default) uses how long the Moon had been in its birth nakshatra (birth star), out of the whole time it takes to cross it (bhayat over bhabhog). This is the classical method. longitude uses how far the Moon had moved through it instead. The two can differ by days, up to about a month. Both are always returned in balance_conventions; this only picks which one the dates are built on.
levelsbodyHow many levels of periods to return, from 1 to 5. 1 gives the main periods (mahadasha), 2 adds sub-periods (antardasha), 3 adds the next level (pratyantardasha), and so on. Default 3.

Main response fields

  • system (string)
  • year_length_days (number)
  • moon_nakshatra_index (number)
  • nakshatra_fraction_elapsed (number)
  • starting_lord (string)
  • balance_at_birth_years (number)
  • balance_method (string)
  • levels (number)
  • periods (array of objects): each item holds lord, start, end, years, partial_at_birth, balance_years, periods.
  • balance_conventions (object): holds longitude, time, used, other, shift_days, sources_agree, note.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dasha/vimshottari" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "system": "vimshottari",
  "year_length_days": 365.25,
  "moon_nakshatra_index": 5,
  "nakshatra_fraction_elapsed": 0.09303881,
  "starting_lord": "Mars",
  "balance_at_birth_years": 6.348728,
  "balance_method": "time",
  "levels": 3,
  "periods": [
    {
      "lord": "Mars",
      "start": "1989-12-20T13:27:09.380502",
      "end": "1996-12-20T07:27:09.380502",
      "years": 7,
      "partial_at_birth": true,
      "balance_years": 6.348728,
      "periods": [
        {
          "lord": "Mars",
          "start": "1989-12-20T13:27:09.380502",
          "end": "1990-05-18T16:54:09.380502",
          "years": 0.408333,
          "elapsed": true,
          "periods": [
            {
              "lord": "Mars",
              "start": "1989-12-20T13:27:09.380502",
              "end": "1989-12-29T06:15:13.880502",
              "years": 0.023819,
              "elapsed": true
            },
            {
              "lord": "Rahu",
              "start": "1989-12-29T06:15:13.880502",
              "end": "1990-01-20T15:10:16.880502",
              "years": 0.06125,
              "elapsed": true
            },
            {
              "lord": "Jupiter",
              "start": "1990-01-20T15:10:16.880502",
              "end": "1990-02-09T12:25:52.880502",
              "years": 0.054444,
              "elapsed": true
            }
          ]
        },
        {
          "lord": "Rahu",
          "start": "1990-05-18T16:54:09.380502",
          "end": "1991-06-06T05:12:09.380502",
          "years": 1.05,
          "periods": [
            {
              "lord": "Rahu",
              "start": "1990-05-18T16:54:09.380502",
              "end": "1990-07-15T05:32:51.380502",
              "years": 0.1575,
              "elapsed": true
            },
            {
              "lord": "Jupiter",
              "start": "1990-07-15T05:32:51.380502",
              "end": "1990-09-04T08:47:15.380502",
              "years": 0.14
            },
            {
              "lord": "Saturn",
              "start": "1990-09-04T08:47:15.380502",
              "end": "1990-11-04T02:08:06.380502",
              "years": 0.16625
            }
          ]
        },
        {
          "lord": "Jupiter",
          "start": "1991-06-06T05:12:09.380502",
          "end": "1992-05-12T02:48:09.380502",
          "years": 0.933333,
          "periods": [
            {
              "lord": "Jupiter",
              "start": "1991-06-06T05:12:09.380502",
              "end": "1991-07-21T16:04:57.380502",
              "years": 0.124444
            },
            {
              "lord": "Saturn",
              "start": "1991-07-21T16:04:57.380502",
              "end": "1991-09-13T15:30:09.380502",
              "years": 0.147778
            },
            {
              "lord": "Mercury",
              "start": "1991-09-13T15:30:09.380502",
              "end": "1991-10-31T22:33:45.380502",
              "years": 0.132222
            }
          ]
        }
      ]
    },
    {
      "lord": "Rahu",
      "start": "1996-12-20T07:27:09.380502",
      "end": "2014-12-20T19:27:09.380502",
      "years": 18,
      "periods": [
        {
          "lord": "Rahu",
          "start": "1996-12-20T07:27:09.380502",
          "end": "1999-09-02T11:39:09.380502",
          "years": 2.7,
          "periods": [
            {
              "lord": "Rahu",
              "start": "1996-12-20T07:27:09.380502",
              "end": "1997-05-17T05:40:57.380502",
              "years": 0.405
            },
            {
              "lord": "Jupiter",
              "start": "1997-05-17T05:40:57.380502",
              "end": "1997-09-25T17:26:33.380502",
              "years": 0.36
            },
            {
              "lord": "Saturn",
              "start": "1997-09-25T17:26:33.380502",
              "end": "1998-02-28T20:54:27.380502",
              "years": 0.4275
            }
          ]
        },
        {
          "lord": "Jupiter",
          "start": "1999-09-02T11:39:09.380502",
          "end": "2002-01-26T02:03:09.380502",
          "years": 2.4,
          "periods": [
            {
              "lord": "Jupiter",
              "start": "1999-09-02T11:39:09.380502",
              "end": "1999-12-28T08:46:21.380502",
              "years": 0.32
            },
            {
              "lord": "Saturn",
              "start": "1999-12-28T08:46:21.380502",
              "end": "2000-05-15T03:51:09.380502",
              "years": 0.38
            },
            {
              "lord": "Mercury",
              "start": "2000-05-15T03:51:09.380502",
              "end": "2000-09-16T08:17:33.380502",
              "years": 0.34
            }
          ]
        },
        {
          "lord": "Saturn",
          "start": "2002-01-26T02:03:09.380502",
          "end": "2004-12-02T01:09:09.380502",
          "years": 2.85,
          "periods": [
            {
              "lord": "Saturn",
              "start": "2002-01-26T02:03:09.380502",
              "end": "2002-07-09T21:42:36.380502",
              "years": 0.45125
            },
            {
              "lord": "Mercury",
              "start": "2002-07-09T21:42:36.380502",
              "end": "2002-12-04T08:58:57.380502",
              "years": 0.40375
            },
            {
              "lord": "Ketu",
              "start": "2002-12-04T08:58:57.380502",
              "end": "2003-02-03T02:19:48.380502",
              "years": 0.16625
            }
          ]
        }
      ]
    },
    {
      "lord": "Jupiter",
      "start": "2014-12-20T19:27:09.380502",
      "end": "2030-12-20T19:27:09.380502",
      "years": 16,
      "periods": [
        {
          "lord": "Jupiter",
          "start": "2014-12-20T19:27:09.380502",
          "end": "2017-02-07T00:15:09.380502",
          "years": 2.133333,
          "periods": [
            {
              "lord": "Jupiter",
              "start": "2014-12-20T19:27:09.380502",
              "end": "2015-04-03T16:53:33.380502",
              "years": 0.284444
            },
            {
              "lord": "Saturn",
              "start": "2015-04-03T16:53:33.380502",
              "end": "2015-08-05T01:51:09.380502",
              "years": 0.337778
            },
            {
              "lord": "Mercury",
              "start": "2015-08-05T01:51:09.380502",
              "end": "2015-11-23T11:07:57.380502",
              "years": 0.302222
            }
          ]
        },
        {
          "lord": "Saturn",
          "start": "2017-02-07T00:15:09.380502",
          "end": "2019-08-21T07:27:09.380502",
          "years": 2.533333,
          "periods": [
            {
              "lord": "Saturn",
              "start": "2017-02-07T00:15:09.380502",
              "end": "2017-07-03T12:23:33.380502",
              "years": 0.401111
            },
            {
              "lord": "Mercury",
              "start": "2017-07-03T12:23:33.380502",
              "end": "2017-11-11T14:24:45.380502",
              "years": 0.358889
            },
            {
              "lord": "Ketu",
              "start": "2017-11-11T14:24:45.380502",
              "end": "2018-01-04T13:49:57.380502",
              "years": 0.147778
            }
          ]
        },
        {
          "lord": "Mercury",
          "start": "2019-08-21T07:27:09.380502",
          "end": "2021-11-26T05:03:09.380502",
          "years": 2.266667,
          "periods": [
            {
              "lord": "Mercury",
              "start": "2019-08-21T07:27:09.380502",
              "end": "2019-12-16T14:18:45.380502",
              "years": 0.321111
            },
            {
              "lord": "Ketu",
              "start": "2019-12-16T14:18:45.380502",
              "end": "2020-02-02T21:22:21.380502",
              "years": 0.132222
            },
            {
              "lord": "Venus",
              "start": "2020-02-02T21:22:21.380502",
              "end": "2020-06-19T20:58:21.380502",
              "years": 0.377778
            }
          ]
        }
      ]
    }
  ],
  "balance_conventions": {
    "longitude": {
      "fraction_elapsed": 0.09312764,
      "balance_years": 6.348107,
      "first_period_ends": "1996-12-20T02:00:06.412309"
    },
    "time": {
      "fraction_elapsed": 0.09303881,
      "balance_years": 6.348728,
      "first_period_ends": "1996-12-20T07:27:09.380502"
    },
    "used": "time",
    "other": "longitude",
    "shift_days": 0.2271,
    "sources_agree": true,
    "note": "longitude measures how far the Moon has moved through its birth nakshatra; time measures how long it has been there (bhayat over bhabhog), as a desktop program does. Every later date moves by the same shift."
  },
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Dashas (planetary periods).

Yogini dasha periods (a 36-year cycle)

POST /v1/dasha/yogini

Returns the Yogini dasha timeline, a second system of dashas (planetary periods) next to Vimshottari. It starts from the same Moon position as Vimshottari. It also measures the time already passed at birth the same way, so the two systems always agree about the starting point.

Eight periods, each named for a yogini and ruled by a planet, add up to 36 years. So the cycle repeats two or three times in a lifetime. By comparison, most people live through only three or four of Vimshottari's main periods (mahadashas). Two levels are returned, periods and sub-periods; a third level would be only days long.

The first period is listed at its full length, so it starts before birth; balance_at_birth_years gives the part that remained at birth.

Neither system overrides the other, and they are not averaged. See rulebook section YD (the API's rule reference).

dasha_balance works as it does on the Vimshottari route: time by default, longitude for the old distance balance. balance_conventions gives both. Use the same setting on both routes and they still agree.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (8), with their defaults
NameInWhat it does
langqueryLanguage for the names in the response, such as planets, signs, nakshatras (lunar mansions), tithis (lunar days), months and festivals. The default is en (English); GET /v1/meta lists the others. Each translated value comes with its English original in a matching <field>_en field; use the English value as a key in your code. Codes (such as result or kaal) and object keys always stay in English. Any name not yet translated stays in English and is listed in localization.untranslated.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.
dasha_balancebodyHow much of the first period was over at birth. time (the default) uses how long the Moon had been in its birth nakshatra (birth star), out of the whole time it takes to cross it (bhayat over bhabhog). This is the classical method. longitude uses how far the Moon had moved through it instead. The two can differ by days, up to about a month. Both are always returned in balance_conventions; this only picks which one the dates are built on.

Main response fields

  • system (string)
  • total_years (number)
  • year_length_days (number)
  • moon_nakshatra_index (number)
  • nakshatra_fraction_elapsed (number)
  • starting_yogini (string)
  • balance_at_birth_years (number)
  • balance_method (string)
  • levels (number)
  • periods (array of objects): each item holds yogini, lord, years, start, end, periods, partial_at_birth, balance_years.
  • balance_conventions (object): holds longitude, time, used, other, shift_days, sources_agree, note.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dasha/yogini" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "system": "yogini",
  "total_years": 36,
  "year_length_days": 365.25,
  "moon_nakshatra_index": 5,
  "nakshatra_fraction_elapsed": 0.09303881,
  "starting_yogini": "Sankata",
  "balance_at_birth_years": 7.25569,
  "balance_method": "time",
  "levels": 2,
  "periods": [
    {
      "yogini": "Sankata",
      "lord": "Rahu",
      "years": 8,
      "start": "1989-11-16T13:52:27.863431",
      "end": "1997-11-16T13:52:27.863431",
      "periods": [
        {
          "yogini": "Sankata",
          "lord": "Rahu",
          "start": "1989-11-16T13:52:27.863431",
          "end": "1991-08-27T21:52:27.863431"
        },
        {
          "yogini": "Mangala",
          "lord": "Moon",
          "start": "1991-08-27T21:52:27.863431",
          "end": "1991-11-17T01:52:27.863431"
        },
        {
          "yogini": "Pingala",
          "lord": "Sun",
          "start": "1991-11-17T01:52:27.863431",
          "end": "1992-04-27T09:52:27.863431"
        }
      ],
      "partial_at_birth": true,
      "balance_years": 7.25569
    },
    {
      "yogini": "Mangala",
      "lord": "Moon",
      "years": 1,
      "start": "1997-11-16T13:52:27.863431",
      "end": "1998-11-16T19:52:27.863431",
      "periods": [
        {
          "yogini": "Mangala",
          "lord": "Moon",
          "start": "1997-11-16T13:52:27.863431",
          "end": "1997-11-26T17:22:27.863431"
        },
        {
          "yogini": "Pingala",
          "lord": "Sun",
          "start": "1997-11-26T17:22:27.863431",
          "end": "1997-12-17T00:22:27.863431"
        },
        {
          "yogini": "Dhanya",
          "lord": "Jupiter",
          "start": "1997-12-17T00:22:27.863431",
          "end": "1998-01-16T10:52:27.863431"
        }
      ]
    },
    {
      "yogini": "Pingala",
      "lord": "Sun",
      "years": 2,
      "start": "1998-11-16T19:52:27.863431",
      "end": "2000-11-16T07:52:27.863431",
      "periods": [
        {
          "yogini": "Pingala",
          "lord": "Sun",
          "start": "1998-11-16T19:52:27.863431",
          "end": "1998-12-27T09:52:27.863431"
        },
        {
          "yogini": "Dhanya",
          "lord": "Jupiter",
          "start": "1998-12-27T09:52:27.863431",
          "end": "1999-02-26T06:52:27.863431"
        },
        {
          "yogini": "Bhramari",
          "lord": "Mars",
          "start": "1999-02-26T06:52:27.863431",
          "end": "1999-05-18T10:52:27.863431"
        }
      ]
    }
  ],
  "balance_conventions": {
    "longitude": {
      "fraction_elapsed": 0.09312764,
      "balance_years": 7.254979,
      "first_period_ends": "1997-11-16T07:38:41.614067"
    },
    "time": {
      "fraction_elapsed": 0.09303881,
      "balance_years": 7.25569,
      "first_period_ends": "1997-11-16T13:52:27.863431"
    },
    "used": "time",
    "other": "longitude",
    "shift_days": 0.2596,
    "sources_agree": true,
    "note": "longitude measures how far the Moon has moved through its birth nakshatra; time measures how long it has been there (bhayat over bhabhog), as a desktop program does. Every later date moves by the same shift."
  },
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Dashas (planetary periods).

Ashtottari dasha periods (a 108-year cycle)

POST /v1/dasha/ashtottari

Returns the Ashtottari dasha timeline, a third system of dashas (planetary periods) next to Vimshottari and Yogini. Eight planets rule periods that add up to 108 years. They are Sun 6, Moon 15, Mars 8, Mercury 17, Saturn 10, Jupiter 19, Rahu 12 and Venus 21. Ketu rules no period.

The starting period comes from the Moon's nakshatra (lunar mansion) at birth. Ashtottari counts 28 of them, including Abhijit, in groups of three or four from Ardra, and each group belongs to one planet. The part already passed at birth is measured by time (bhayat over bhabhog), the same way as Vimshottari and Yogini (rulebook DA-03). dasha_balance works as it does on the Vimshottari and Yogini routes: time by default, longitude for the old distance balance. balance_method names which was used, and balance_conventions gives both.

Set levels to 1, 2 or 3 for main periods, sub-periods and sub-sub-periods. The default is 3. The first main period is listed at its full length, so it starts before birth. balance_at_birth_years gives the part that remained at birth.

Whether it applies. The classical texts use Ashtottari only for some charts. applicability checks the two conditions. The first is Rahu in an angle or a trine counted from the ascendant's ruler, but not in the first house. The second is birth in the waning half of the lunar month by day, or in the waxing half by night. Sources differ on whether one condition is enough or both are needed. So applicable is true when either one holds, and both_conditions_met when both do. sources_agree says whether those two answers are the same. The periods are returned either way. See rulebook section AD (the API's rule reference).

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (9), with their defaults
NameInWhat it does
langqueryLanguage for the names in the response, such as planets, signs, nakshatras (lunar mansions), tithis (lunar days), months and festivals. The default is en (English); GET /v1/meta lists the others. Each translated value comes with its English original in a matching <field>_en field; use the English value as a key in your code. Codes (such as result or kaal) and object keys always stay in English. Any name not yet translated stays in English and is listed in localization.untranslated.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.
dasha_balancebodyHow much of the first period was over at birth. time (the default) uses how long the Moon had been in its birth nakshatra (birth star), out of the whole time it takes to cross it (bhayat over bhabhog). This is the classical method. longitude uses how far the Moon had moved through it instead. The two can differ by days, up to about a month. Both are always returned in balance_conventions; this only picks which one the dates are built on.
levelsbodyHow many levels of periods to return, from 1 to 3. 1 gives the main periods (mahadasha), 2 adds sub-periods (antardasha), 3 adds the next level (pratyantardasha). Default 3.

Main response fields

  • system (string)
  • total_years (number)
  • year_length_days (number)
  • balance_method (string)
  • moon_nakshatra_index (number)
  • nakshatra_fraction_elapsed (number)
  • moon_star (string)
  • star_fraction_elapsed (number)
  • star_group (object): holds lord, position, of.
  • starting_lord (string)
  • balance_at_birth_years (number)
  • levels (number)
  • periods (array of objects): each item holds lord, years, start, end, partial_at_birth, balance_years, periods.
  • balance_conventions (object): holds longitude, time, used, other, shift_days, sources_agree, note.
  • applicability (object): holds applicable, both_conditions_met, sources_agree, conditions, rule.
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dasha/ashtottari" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "system": "ashtottari",
  "total_years": 108,
  "year_length_days": 365.25,
  "balance_method": "time",
  "moon_nakshatra_index": 5,
  "nakshatra_fraction_elapsed": 0.09303881,
  "moon_star": "Mrigashira",
  "star_fraction_elapsed": 0.09303881,
  "star_group": {
    "lord": "Venus",
    "position": 3,
    "of": 3
  },
  "starting_lord": "Venus",
  "balance_at_birth_years": 6.348728,
  "levels": 3,
  "periods": [
    {
      "lord": "Venus",
      "years": 21,
      "start": "1975-12-21T01:27:09.380502",
      "end": "1996-12-20T07:27:09.380502",
      "partial_at_birth": true,
      "balance_years": 6.348728,
      "periods": [
        {
          "lord": "Venus",
          "start": "1975-12-21T01:27:09.380502",
          "end": "1980-01-20T11:57:09.380502",
          "years": 4.083333,
          "elapsed": true,
          "periods": [
            {
              "lord": "Venus",
              "start": "1975-12-21T01:27:09.380502",
              "end": "1976-10-06T01:29:39.380502",
              "years": 0.793981,
              "elapsed": true
            },
            {
              "lord": "Sun",
              "start": "1976-10-06T01:29:39.380502",
              "end": "1976-12-27T22:04:39.380502",
              "years": 0.226852,
              "elapsed": true
            },
            {
              "lord": "Moon",
              "start": "1976-12-27T22:04:39.380502",
              "end": "1977-07-23T01:32:09.380502",
              "years": 0.56713,
              "elapsed": true
            }
          ]
        },
        {
          "lord": "Sun",
          "start": "1980-01-20T11:57:09.380502",
          "end": "1981-03-21T14:57:09.380502",
          "years": 1.166667,
          "elapsed": true,
          "periods": [
            {
              "lord": "Sun",
              "start": "1980-01-20T11:57:09.380502",
              "end": "1980-02-13T04:07:09.380502",
              "years": 0.064815,
              "elapsed": true
            },
            {
              "lord": "Moon",
              "start": "1980-02-13T04:07:09.380502",
              "end": "1980-04-12T08:32:09.380502",
              "years": 0.162037,
              "elapsed": true
            },
            {
              "lord": "Mars",
              "start": "1980-04-12T08:32:09.380502",
              "end": "1980-05-13T22:05:29.380502",
              "years": 0.08642,
              "elapsed": true
            }
          ]
        },
        {
          "lord": "Moon",
          "start": "1981-03-21T14:57:09.380502",
          "end": "1984-02-19T22:27:09.380502",
          "years": 2.916667,
          "elapsed": true,
          "periods": [
            {
              "lord": "Moon",
              "start": "1981-03-21T14:57:09.380502",
              "end": "1981-08-16T13:59:39.380502",
              "years": 0.405093,
              "elapsed": true
            },
            {
              "lord": "Mars",
              "start": "1981-08-16T13:59:39.380502",
              "end": "1981-11-03T11:52:59.380502",
              "years": 0.216049,
              "elapsed": true
            },
            {
              "lord": "Mercury",
              "start": "1981-11-03T11:52:59.380502",
              "end": "1982-04-20T04:23:49.380502",
              "years": 0.459105,
              "elapsed": true
            }
          ]
        }
      ]
    },
    {
      "lord": "Sun",
      "years": 6,
      "start": "1996-12-20T07:27:09.380502",
      "end": "2002-12-20T19:27:09.380502",
      "periods": [
        {
          "lord": "Sun",
          "start": "1996-12-20T07:27:09.380502",
          "end": "1997-04-21T01:27:09.380502",
          "years": 0.333333,
          "periods": [
            {
              "lord": "Sun",
              "start": "1996-12-20T07:27:09.380502",
              "end": "1996-12-27T01:47:09.380502",
              "years": 0.018519
            },
            {
              "lord": "Moon",
              "start": "1996-12-27T01:47:09.380502",
              "end": "1997-01-12T23:37:09.380502",
              "years": 0.046296
            },
            {
              "lord": "Mars",
              "start": "1997-01-12T23:37:09.380502",
              "end": "1997-01-22T00:03:49.380502",
              "years": 0.024691
            }
          ]
        },
        {
          "lord": "Moon",
          "start": "1997-04-21T01:27:09.380502",
          "end": "1998-02-19T10:27:09.380502",
          "years": 0.833333,
          "periods": [
            {
              "lord": "Moon",
              "start": "1997-04-21T01:27:09.380502",
              "end": "1997-06-02T08:02:09.380502",
              "years": 0.115741
            },
            {
              "lord": "Mars",
              "start": "1997-06-02T08:02:09.380502",
              "end": "1997-06-24T21:08:49.380502",
              "years": 0.061728
            },
            {
              "lord": "Mercury",
              "start": "1997-06-24T21:08:49.380502",
              "end": "1997-08-11T19:00:29.380502",
              "years": 0.131173
            }
          ]
        },
        {
          "lord": "Mars",
          "start": "1998-02-19T10:27:09.380502",
          "end": "1998-07-31T18:27:09.380502",
          "years": 0.444444,
          "periods": [
            {
              "lord": "Mars",
              "start": "1998-02-19T10:27:09.380502",
              "end": "1998-03-03T11:02:42.713835",
              "years": 0.032922
            },
            {
              "lord": "Mercury",
              "start": "1998-03-03T11:02:42.713835",
              "end": "1998-03-29T00:18:16.047168",
              "years": 0.069959
            },
            {
              "lord": "Saturn",
              "start": "1998-03-29T00:18:16.047168",
              "end": "1998-04-13T01:02:42.713835",
              "years": 0.041152
            }
          ]
        }
      ]
    },
    {
      "lord": "Moon",
      "years": 15,
      "start": "2002-12-20T19:27:09.380502",
      "end": "2017-12-20T13:27:09.380502",
      "periods": [
        {
          "lord": "Moon",
          "start": "2002-12-20T19:27:09.380502",
          "end": "2005-01-19T17:57:09.380502",
          "years": 2.083333,
          "periods": [
            {
              "lord": "Moon",
              "start": "2002-12-20T19:27:09.380502",
              "end": "2003-04-05T11:54:39.380502",
              "years": 0.289352
            },
            {
              "lord": "Mars",
              "start": "2003-04-05T11:54:39.380502",
              "end": "2003-05-31T20:41:19.380502",
              "years": 0.154321
            },
            {
              "lord": "Mercury",
              "start": "2003-05-31T20:41:19.380502",
              "end": "2003-09-28T15:20:29.380502",
              "years": 0.327932
            }
          ]
        },
        {
          "lord": "Mars",
          "start": "2005-01-19T17:57:09.380502",
          "end": "2006-03-01T13:57:09.380502",
          "years": 1.111111,
          "periods": [
            {
              "lord": "Mars",
              "start": "2005-01-19T17:57:09.380502",
              "end": "2005-02-18T19:26:02.713835",
              "years": 0.082305
            },
            {
              "lord": "Mercury",
              "start": "2005-02-18T19:26:02.713835",
              "end": "2005-04-23T16:34:56.047168",
              "years": 0.174897
            },
            {
              "lord": "Saturn",
              "start": "2005-04-23T16:34:56.047168",
              "end": "2005-05-31T06:26:02.713835",
              "years": 0.102881
            }
          ]
        },
        {
          "lord": "Mercury",
          "start": "2006-03-01T13:57:09.380502",
          "end": "2008-07-10T23:27:09.380502",
          "years": 2.361111,
          "periods": [
            {
              "lord": "Mercury",
              "start": "2006-03-01T13:57:09.380502",
              "end": "2006-07-15T07:53:32.713835",
              "years": 0.371656
            },
            {
              "lord": "Saturn",
              "start": "2006-07-15T07:53:32.713835",
              "end": "2006-10-03T04:19:39.380502",
              "years": 0.218621
            },
            {
              "lord": "Jupiter",
              "start": "2006-10-03T04:19:39.380502",
              "end": "2007-03-03T21:33:16.047169",
              "years": 0.415381
            }
          ]
        }
      ]
    }
  ],
  "balance_conventions": {
    "longitude": {
      "fraction_elapsed": 0.69770921,
      "balance_years": 6.348107,
      "first_period_ends": "1996-12-20T02:00:06.412309"
    },
    "time": {
      "fraction_elapsed": 0.6976796,
      "balance_years": 6.348728,
      "first_period_ends": "1996-12-20T07:27:09.380502"
    },
    "used": "time",
    "other": "longitude",
    "shift_days": 0.2271,
    "sources_agree": true,
    "note": "longitude measures how far the Moon has moved through its star; time measures how long it has been there (bhayat over bhabhog), the astrologer's N-26 boundaries for the three Abhijit-adjusted stars. Every later date moves by the same shift."
  },
  "applicability": {
    "applicable": true,
    "both_conditions_met": false,
    "sources_agree": false,
    "conditions": {
      "rahu": {
        "met": false,
        "lagna_lord": "Mercury",
        "rahu_house": 5,
        "rahu_from_lagna_lord": 6,
        "in_kendra_or_trikona_from_lagna_lord": false,
        "in_lagna": false
      },
      "paksha": {
        "met": true,
        "paksha": "krishna",
        "born_by_day": true
      }
    },
    "rule": "BPHS chapter 46: Rahu in a kendra or trikona from the lagna lord, not in the lagna. Or: birth in krishna paksha by day or shukla paksha by night. `applicable` reads the two as either, `both_conditions_met` as both."
  },
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Dashas (planetary periods).

Narayana dasha: the Jaimini sign periods

POST /v1/dasha/narayana

Returns the Narayana dasha timeline. It is a Jaimini dasha: each period is run by a sign, not a planet. It takes the same birth details as /v1/dasha/vimshottari.

Where it starts. The first period is the stronger of the ascendant sign and the sign opposite it (the 7th). Strength is tested rule by rule: more planets in the sign, then more of Jupiter, Mercury and the sign's own ruler joining or aspecting it, then more exalted planets, then the ruler sitting in a sign of the other kind (odd or even), then the ruler further through its sign. The first rule that separates the two decides. start_comparison shows every test that was run.

Order. The direction comes from the 9th sign from the starting sign. Saturn in the starting sign makes the periods run forward, one sign after another; Ketu there turns the direction around. Signs come in three kinds: movable, fixed and dual. A movable start takes the signs in order. A fixed start jumps six signs each time. A dual start takes each angle sign with its two trine signs (1, 5, 9, then 10, 2, 6, and so on).

Length. Count from the sign to its ruler, minus one, 12 for a ruler in its own sign. One year is added for an exalted ruler and taken off for a debilitated one. Each period carries why, the working.

dated gives both rounds of twelve with dates from birth, in the local time of the birth place. The second round runs each sign for 12 minus its first years, so the two total 144 years. Each period has 12 equal sub-periods (antardashas). A year is 365.25 days.

Where texts read a step differently, choices names the reading used, and not_computed lists what is left out. intro says in plain words what Narayana dasha is. Each period's text is the sign reading /v1/jaimini gives for chara dasha, without its opening line about chara dasha. See rulebook JM-10 to JM-13. Add ?lang=hi for Hindi.

Cost: Each successful request counts as 1 call toward your monthly calls.

Required inputs

NameInWhat it is
yearbodyYear of birth, from 1850 to 2149 (the range the planetary data covers).
monthbodyMonth of birth, from 1 (January) to 12 (December).
daybodyDay of the month, from 1 to 31.
latitudebodyLatitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted.
longitudebodyLongitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted.
timezonebodyTime zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5.
Optional inputs (8), with their defaults
NameInWhat it does
langqueryLanguage of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too.
detailqueryLength of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field.
hourbodyHour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0.
minutebodyMinute of birth, from 0 to 59. Default 0.
secondbodySecond of birth, from 0 to 59. Default 0.
timezone_foldbodyOnly needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force.
ayanamsabodyThe ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart.
nodebodyHow to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position.

Main response fields

  • system (string)
  • starting_sign (string)
  • start_comparison (object): holds stronger, sign_number, decided_by, steps, between.
  • direction (string)
  • direction_rule (string)
  • progression (string)
  • progression_rule (string)
  • exceptions_applied (array)
  • periods (array of objects): each item holds sign, sign_number, lord, lord_sign, base_years, years, why, starts_after_years, text, reading_shared_with, language, detail.
  • cycle_years (number)
  • rule (string)
  • choices (array of objects): each item holds rule, step, chosen, other_reading.
  • not_computed (array of strings)
  • note (string)
  • dated (object): holds year_length_days, periods, total_years, second_cycle_rule, antardasha_rule, note.
  • intro (object): holds text, language, detail.
  • gaps (array)
  • language (string)
  • detail (string)
  • meta (object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dasha/narayana" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Sample response
{
  "system": "narayana",
  "starting_sign": "Virgo",
  "start_comparison": {
    "stronger": "Virgo",
    "sign_number": 6,
    "decided_by": "lord_in_other_parity",
    "steps": [
      {
        "rule": "more_grahas",
        "test": "the sign holding more grahas",
        "first": {
          "sign": "Virgo",
          "value": []
        },
        "second": {
          "sign": "Pisces",
          "value": []
        }
      },
      {
        "rule": "jupiter_mercury_lord",
        "test": "the sign joined or aspected (by sign aspect) by more of Jupiter, Mercury and its own lord",
        "first": {
          "sign": "Virgo",
          "value": []
        },
        "second": {
          "sign": "Pisces",
          "value": []
        }
      },
      {
        "rule": "more_exalted",
        "test": "the sign holding more exalted grahas",
        "first": {
          "sign": "Virgo",
          "value": []
        },
        "second": {
          "sign": "Pisces",
          "value": []
        }
      }
    ],
    "between": [
      "Virgo",
      "Pisces"
    ]
  },
  "direction": "forward",
  "direction_rule": "the 9th from Virgo is Taurus, which is odd-footed, so forward",
  "progression": "dual",
  "progression_rule": "the kendras from the starting sign, each followed by its trines (1 5 9, then 10 2 6, 7 11 3 and 4 8 12)",
  "exceptions_applied": [],
  "periods": [
    {
      "sign": "Virgo",
      "sign_number": 6,
      "lord": "Mercury",
      "lord_sign": "Leo",
      "base_years": 1,
      "years": 1,
      "why": "Mercury is 2 signs from Virgo counting backward, minus one",
      "starts_after_years": 0,
      "text": [
        "A Virgo period is a working period, not a showy one. Virgo is the sign of careful method and precision. So the period fills with service, health routines, debt, competition and the dull details of things. You tend to handle them well.…",
        "What helps: bring to this period the tedious job you have put off for years, and it often gives way. Old tax papers, a messy set of accounts or a long-stalled repair are good candidates. What the period rarely gives is recognition. The…"
      ],
      "reading_shared_with": "chara_dasha",
      "language": "en",
      "detail": "standard"
    },
    {
      "sign": "Capricorn",
      "sign_number": 10,
      "lord": "Saturn",
      "lord_sign": "Sagittarius",
      "base_years": 1,
      "years": 1,
      "why": "Saturn is 2 signs from Capricorn counting backward, minus one",
      "starts_after_years": 1,
      "text": [
        "Capricorn's chapter is hard work. Capricorn is the sign of duty and structure. So responsibility arrives, and recognition lags well behind the effort. What you build often lasts precisely because it was slow. Older people, institutions and…",
        "This period usually pays late in its term, not early. Many people decide at the midpoint that it isn't paying at all. Then they drop the very thing that would have paid. What helps: hold your course through the middle years. Expect…"
      ],
      "reading_shared_with": "chara_dasha",
      "language": "en",
      "detail": "standard"
    },
    {
      "sign": "Taurus",
      "sign_number": 2,
      "lord": "Venus",
      "lord_sign": "Cancer",
      "base_years": 2,
      "years": 2,
      "why": "Venus is 3 signs from Taurus counting forward, minus one",
      "starts_after_years": 2,
      "text": [
        "Each sign sets the tone of its own years. Taurus is an earth sign that values what lasts, so its period is usually slow, steady and hard to shift. Money and resources build up bit by bit rather than arriving all at once. What you build now…",
        "What helps: use this time for building up savings, property, skills and anything that grows by being added to. A change of direction started now can take most of the period to finish. So be sure before the first step rather than finding…"
      ],
      "reading_shared_with": "chara_dasha",
      "language": "en",
      "detail": "standard"
    }
  ],
  "cycle_years": 57,
  "rule": "Narayana dasha (Jaimini, as stated by P. V. R. Narasimha Rao): start from the stronger of the lagna and the 7th; direction from the 9th from that sign, with the Saturn and Ketu exceptions; order by the starting sign's quality; each sign…",
  "choices": [
    {
      "rule": "JM-10",
      "step": "which grahas count in the strength rules",
      "chosen": "all nine, Rahu and Ketu included",
      "other_reading": "the seven grahas from the Sun to Saturn"
    },
    {
      "rule": "JM-10",
      "step": "strength rules after the second",
      "chosen": "more exalted grahas, then the lord in a sign of the other parity (odd or even), then the lord further through its sign; the lagna (or the dasha sign) if all tie",
      "other_reading": "some lists order these differently or end at the longer dasha period"
    },
    {
      "rule": "JM-11",
      "step": "Saturn and Ketu both in the starting sign",
      "chosen": "Saturn makes the order zodiacal and one sign after another; Ketu then reverses it",
      "other_reading": "Saturn alone decides and Ketu is ignored"
    }
  ],
  "not_computed": [
    "pratyantardashas (the level below the antardasha); DR-04 already declines to read periods that short",
    "Narayana dasha of the divisional charts (D-9, D-10 and the rest), which start from a different seed sign",
    "the padakrama (arudha based) and other variant Narayana dashas"
  ],
  "note": "Narayana dasha and chara dasha count the same years for most signs but start, run and divide differently. Neither overrides the other. Rulebook JM-10 to JM-13.",
  "dated": {
    "year_length_days": 365.25,
    "periods": [
      {
        "cycle": 1,
        "sign": "Virgo",
        "sign_number": 6,
        "years": 1,
        "start": "1990-08-15T10:30:00",
        "end": "1991-08-15T16:30:00",
        "antardasha_seed": "Virgo",
        "antardasha_seed_decided_by": "lord_in_other_parity",
        "antardasha_seed_lord": "Mercury",
        "antardasha_start_sign": "Leo",
        "antardasha_direction": "forward",
        "antardashas": [
          {
            "sign": "Leo",
            "sign_number": 5,
            "start": "1990-08-15T10:30:00",
            "end": "1990-09-14T21:00:00"
          },
          {
            "sign": "Virgo",
            "sign_number": 6,
            "start": "1990-09-14T21:00:00",
            "end": "1990-10-15T07:30:00"
          },
          {
            "sign": "Libra",
            "sign_number": 7,
            "start": "1990-10-15T07:30:00",
            "end": "1990-11-14T18:00:00"
          }
        ]
      },
      {
        "cycle": 1,
        "sign": "Capricorn",
        "sign_number": 10,
        "years": 1,
        "start": "1991-08-15T16:30:00",
        "end": "1992-08-14T22:30:00",
        "antardasha_seed": "Cancer",
        "antardasha_seed_decided_by": "more_grahas",
        "antardasha_seed_lord": "Moon",
        "antardasha_start_sign": "Taurus",
        "antardasha_direction": "backward",
        "antardashas": [
          {
            "sign": "Taurus",
            "sign_number": 2,
            "start": "1991-08-15T16:30:00",
            "end": "1991-09-15T03:00:00"
          },
          {
            "sign": "Aries",
            "sign_number": 1,
            "start": "1991-09-15T03:00:00",
            "end": "1991-10-15T13:30:00"
          },
          {
            "sign": "Pisces",
            "sign_number": 12,
            "start": "1991-10-15T13:30:00",
            "end": "1991-11-15T00:00:00"
          }
        ]
      },
      {
        "cycle": 1,
        "sign": "Taurus",
        "sign_number": 2,
        "years": 2,
        "start": "1992-08-14T22:30:00",
        "end": "1994-08-15T10:30:00",
        "antardasha_seed": "Taurus",
        "antardasha_seed_decided_by": "more_grahas",
        "antardasha_seed_lord": "Venus",
        "antardasha_start_sign": "Cancer",
        "antardasha_direction": "backward",
        "antardashas": [
          {
            "sign": "Cancer",
            "sign_number": 4,
            "start": "1992-08-14T22:30:00",
            "end": "1992-10-14T19:30:00"
          },
          {
            "sign": "Gemini",
            "sign_number": 3,
            "start": "1992-10-14T19:30:00",
            "end": "1992-12-14T16:30:00"
          },
          {
            "sign": "Taurus",
            "sign_number": 2,
            "start": "1992-12-14T16:30:00",
            "end": "1993-02-13T13:30:00"
          }
        ]
      }
    ],
    "total_years": 144,
    "second_cycle_rule": "each sign runs again in the same order for twelve minus its first-cycle years. A sign that ran twelve years has no second period",
    "antardasha_rule": "twelve equal parts. Find the stronger of the dasha sign and the 7th from it (the same strength rules as the start). The antardashas start from the sign its lord sits in and run one sign after another: forward from an odd sign, backward…",
    "note": "dates are local civil time at the birth place, with a year of 365.25 days, as in chara dasha and Vimshottari. See rulebook JM-13."
  },
  "intro": {
    "text": [
      "Narayana dasha is a sign-based timing system from Jaimini astrology. It divides your life into periods, one for each sign. Each period shows the setting you live in, the outside circumstances around you, and the general direction your life…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.

Parameters, schemas and a test request in the interactive reference. Feature: Jaimini astrology.

How we check the numbers

Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test accuracy.

Terms in this group

From the blog