Dasha

Vimshottari periods to five levels (prana), Yogini and Chara, and the periods running at a given moment.

Vimshottari periods to 5 levels

POST/v1/dasha/vimshottari

2 credits · Secret key (test or live) · getVimshottari · Page for this operation

depth 5 (prana) needs from and to at most 31 days apart; every level is then limited to that range. data.basis gives the inputs of the balance at birth (the full-precision Moon, the nakshatra and the year length), so every boundary can be reproduced; options.dasha_year sets the year length.

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
depth integer
≥ 1 · ≤ 5 · default 2
from string (date)
e.g. "1990-08-13"
to string (date)
e.g. "1990-08-13"
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
- tone string
  descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
  one of default, descriptive · default "default"
- dasha_year number
  Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
  one of 365.25, 365.2422, 360 · default 365.25
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

periods array of object required
- planet string required
- start string (date-time) required
- end string (date-time) required
- sub array of object
basis DashaBasis required
- moon_longitude number required
  The sidereal Moon at the birth instant, full precision (degrees).
- ayanamsa number required
  The ayanamsa at the birth instant (degrees), of the system in meta.ayanamsa (Lahiri unless options.ayanamsa).
- nakshatra object required
  Fields
  - id string required
  - number integer required
    ≥ 1 · ≤ 27
  - lord string required
  - start number required
  - end number required
- elapsed_fraction number required
  ≥ 0 · ≤ 1
- remaining_fraction number required
  ≥ 0 · ≤ 1
- balance object required
  Fields
  - planet string required
  - years number required
  - days number required
- year_days number required
- birth string (date-time) required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/dasha/vimshottari' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"depth":2}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/dasha/vimshottari", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "depth": 2
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "depth": 2,
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/dasha/vimshottari",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/dasha/vimshottari');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"depth":2}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 27,760 characters

{
  "data": {
    "periods": [
      {
        "planet": "venus",
        "start": "1990-08-13T01:00:00.000Z",
        "end": "2003-06-21T22:53:13.747Z",
        "sub": [
          {
            "planet": "mars",
            "start": "1990-08-13T01:00:00.000Z",
            "end": "1990-08-21T13:53:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "1990-08-21T13:53:13.747Z",
            "end": "1993-08-21T07:53:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "1993-08-21T07:53:13.747Z",
            "end": "1996-04-21T07:53:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "1996-04-21T07:53:13.747Z",
            "end": "1999-06-21T22:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "1999-06-21T22:53:13.747Z",
            "end": "2002-04-21T19:53:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2002-04-21T19:53:13.747Z",
            "end": "2003-06-21T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "sun",
        "start": "2003-06-21T22:53:13.747Z",
        "end": "2009-06-21T10:53:13.747Z",
        "sub": [
          {
            "planet": "sun",
            "start": "2003-06-21T22:53:13.747Z",
            "end": "2003-10-09T12:41:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2003-10-09T12:41:13.747Z",
            "end": "2004-04-09T03:41:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2004-04-09T03:41:13.747Z",
            "end": "2004-08-14T23:47:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2004-08-14T23:47:13.747Z",
            "end": "2005-07-09T17:11:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2005-07-09T17:11:13.747Z",
            "end": "2006-04-27T21:59:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2006-04-27T21:59:13.747Z",
            "end": "2007-04-09T21:41:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2007-04-09T21:41:13.747Z",
            "end": "2008-02-14T08:47:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2008-02-14T08:47:13.747Z",
            "end": "2008-06-21T04:53:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2008-06-21T04:53:13.747Z",
            "end": "2009-06-21T10:53:13.747Z"
          }
        ]
      },
      {
        "planet": "moon",
        "start": "2009-06-21T10:53:13.747Z",
        "end": "2019-06-21T22:53:13.747Z",
        "sub": [
          {
            "planet": "moon",
            "start": "2009-06-21T10:53:13.747Z",
            "end": "2010-04-21T19:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2010-04-21T19:53:13.747Z",
            "end": "2010-11-20T21:23:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2010-11-20T21:23:13.747Z",
            "end": "2012-05-21T18:23:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2012-05-21T18:23:13.747Z",
            "end": "2013-09-20T18:23:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2013-09-20T18:23:13.747Z",
            "end": "2015-04-22T01:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2015-04-22T01:53:13.747Z",
            "end": "2016-09-20T12:23:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2016-09-20T12:23:13.747Z",
            "end": "2017-04-21T13:53:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2017-04-21T13:53:13.747Z",
            "end": "2018-12-21T07:53:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2018-12-21T07:53:13.747Z",
            "end": "2019-06-21T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "mars",
        "start": "2019-06-21T22:53:13.747Z",
        "end": "2026-06-21T16:53:13.747Z",
        "sub": [
          {
            "planet": "mars",
            "start": "2019-06-21T22:53:13.747Z",
            "end": "2019-11-18T02:20:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2019-11-18T02:20:13.747Z",
            "end": "2020-12-05T14:38:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2020-12-05T14:38:13.747Z",
            "end": "2021-11-11T12:14:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2021-11-11T12:14:13.747Z",
            "end": "2022-12-21T07:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2022-12-21T07:53:13.747Z",
            "end": "2023-12-18T12:50:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2023-12-18T12:50:13.747Z",
            "end": "2024-05-15T16:17:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2024-05-15T16:17:13.747Z",
            "end": "2025-07-15T19:17:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2025-07-15T19:17:13.747Z",
            "end": "2025-11-20T15:23:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2025-11-20T15:23:13.747Z",
            "end": "2026-06-21T16:53:13.747Z"
          }
        ]
      },
      {
        "planet": "rahu",
        "start": "2026-06-21T16:53:13.747Z",
        "end": "2044-06-21T04:53:13.747Z",
        "sub": [
          {
            "planet": "rahu",
            "start": "2026-06-21T16:53:13.747Z",
            "end": "2029-03-03T21:05:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2029-03-03T21:05:13.747Z",
            "end": "2031-07-28T11:29:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2031-07-28T11:29:13.747Z",
            "end": "2034-06-03T10:35:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2034-06-03T10:35:13.747Z",
            "end": "2036-12-20T19:53:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2036-12-20T19:53:13.747Z",
            "end": "2038-01-08T08:11:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2038-01-08T08:11:13.747Z",
            "end": "2041-01-08T02:11:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2041-01-08T02:11:13.747Z",
            "end": "2041-12-02T19:35:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2041-12-02T19:35:13.747Z",
            "end": "2043-06-03T16:35:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2043-06-03T16:35:13.747Z",
            "end": "2044-06-21T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "jupiter",
        "start": "2044-06-21T04:53:13.747Z",
        "end": "2060-06-21T04:53:13.747Z",
        "sub": [
          {
            "planet": "jupiter",
            "start": "2044-06-21T04:53:13.747Z",
            "end": "2046-08-09T09:41:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2046-08-09T09:41:13.747Z",
            "end": "2049-02-19T16:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2049-02-19T16:53:13.747Z",
            "end": "2051-05-28T14:29:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2051-05-28T14:29:13.747Z",
            "end": "2052-05-03T12:05:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2052-05-03T12:05:13.747Z",
            "end": "2055-01-02T12:05:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2055-01-02T12:05:13.747Z",
            "end": "2055-10-21T16:53:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2055-10-21T16:53:13.747Z",
            "end": "2057-02-19T16:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2057-02-19T16:53:13.747Z",
            "end": "2058-01-26T14:29:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2058-01-26T14:29:13.747Z",
            "end": "2060-06-21T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "saturn",
        "start": "2060-06-21T04:53:13.747Z",
        "end": "2079-06-21T22:53:13.747Z",
        "sub": [
          {
            "planet": "saturn",
            "start": "2060-06-21T04:53:13.747Z",
            "end": "2063-06-24T23:56:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2063-06-24T23:56:13.747Z",
            "end": "2066-03-04T03:05:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2066-03-04T03:05:13.747Z",
            "end": "2067-04-12T22:44:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2067-04-12T22:44:13.747Z",
            "end": "2070-06-12T13:44:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2070-06-12T13:44:13.747Z",
            "end": "2071-05-25T13:26:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2071-05-25T13:26:13.747Z",
            "end": "2072-12-23T20:56:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2072-12-23T20:56:13.747Z",
            "end": "2074-02-01T16:35:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2074-02-01T16:35:13.747Z",
            "end": "2076-12-08T15:41:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2076-12-08T15:41:13.747Z",
            "end": "2079-06-21T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "mercury",
        "start": "2079-06-21T22:53:13.747Z",
        "end": "2096-06-21T04:53:13.747Z",
        "sub": [
          {
            "planet": "mercury",
            "start": "2079-06-21T22:53:13.747Z",
            "end": "2081-11-17T14:20:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2081-11-17T14:20:13.747Z",
            "end": "2082-11-14T19:17:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2082-11-14T19:17:13.747Z",
            "end": "2085-09-14T16:17:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2085-09-14T16:17:13.747Z",
            "end": "2086-07-22T03:23:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2086-07-22T03:23:13.747Z",
            "end": "2087-12-21T13:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2087-12-21T13:53:13.747Z",
            "end": "2088-12-17T18:50:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2088-12-17T18:50:13.747Z",
            "end": "2091-07-07T04:08:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2091-07-07T04:08:13.747Z",
            "end": "2093-10-12T01:44:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2093-10-12T01:44:13.747Z",
            "end": "2096-06-21T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "ketu",
        "start": "2096-06-21T04:53:13.747Z",
        "end": "2103-06-22T22:53:13.747Z",
        "sub": [
          {
            "planet": "ketu",
            "start": "2096-06-21T04:53:13.747Z",
            "end": "2096-11-17T08:20:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2096-11-17T08:20:13.747Z",
            "end": "2098-01-17T11:20:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2098-01-17T11:20:13.747Z",
            "end": "2098-05-25T07:26:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2098-05-25T07:26:13.747Z",
            "end": "2098-12-24T08:56:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2098-12-24T08:56:13.747Z",
            "end": "2099-05-22T12:23:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2099-05-22T12:23:13.747Z",
            "end": "2100-06-10T00:41:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2100-06-10T00:41:13.747Z",
            "end": "2101-05-16T22:17:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2101-05-16T22:17:13.747Z",
            "end": "2102-06-25T17:56:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2102-06-25T17:56:13.747Z",
            "end": "2103-06-22T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "venus",
        "start": "2103-06-22T22:53:13.747Z",
        "end": "2123-06-22T22:53:13.747Z",
        "sub": [
          {
            "planet": "venus",
            "start": "2103-06-22T22:53:13.747Z",
            "end": "2106-10-22T10:53:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2106-10-22T10:53:13.747Z",
            "end": "2107-10-22T16:53:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2107-10-22T16:53:13.747Z",
            "end": "2109-06-22T10:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2109-06-22T10:53:13.747Z",
            "end": "2110-08-22T13:53:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2110-08-22T13:53:13.747Z",
            "end": "2113-08-22T07:53:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2113-08-22T07:53:13.747Z",
            "end": "2116-04-22T07:53:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2116-04-22T07:53:13.747Z",
            "end": "2119-06-22T22:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2119-06-22T22:53:13.747Z",
            "end": "2122-04-22T19:53:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2122-04-22T19:53:13.747Z",
            "end": "2123-06-22T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "sun",
        "start": "2123-06-22T22:53:13.747Z",
        "end": "2129-06-22T10:53:13.747Z",
        "sub": [
          {
            "planet": "sun",
            "start": "2123-06-22T22:53:13.747Z",
            "end": "2123-10-10T12:41:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2123-10-10T12:41:13.747Z",
            "end": "2124-04-10T03:41:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2124-04-10T03:41:13.747Z",
            "end": "2124-08-15T23:47:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2124-08-15T23:47:13.747Z",
            "end": "2125-07-10T17:11:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2125-07-10T17:11:13.747Z",
            "end": "2126-04-28T21:59:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2126-04-28T21:59:13.747Z",
            "end": "2127-04-10T21:41:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2127-04-10T21:41:13.747Z",
            "end": "2128-02-15T08:47:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2128-02-15T08:47:13.747Z",
            "end": "2128-06-22T04:53:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2128-06-22T04:53:13.747Z",
            "end": "2129-06-22T10:53:13.747Z"
          }
        ]
      },
      {
        "planet": "moon",
        "start": "2129-06-22T10:53:13.747Z",
        "end": "2139-06-22T22:53:13.747Z",
        "sub": [
          {
            "planet": "moon",
            "start": "2129-06-22T10:53:13.747Z",
            "end": "2130-04-22T19:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2130-04-22T19:53:13.747Z",
            "end": "2130-11-21T21:23:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2130-11-21T21:23:13.747Z",
            "end": "2132-05-22T18:23:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2132-05-22T18:23:13.747Z",
            "end": "2133-09-21T18:23:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2133-09-21T18:23:13.747Z",
            "end": "2135-04-23T01:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2135-04-23T01:53:13.747Z",
            "end": "2136-09-21T12:23:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2136-09-21T12:23:13.747Z",
            "end": "2137-04-22T13:53:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2137-04-22T13:53:13.747Z",
            "end": "2138-12-22T07:53:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2138-12-22T07:53:13.747Z",
            "end": "2139-06-22T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "mars",
        "start": "2139-06-22T22:53:13.747Z",
        "end": "2146-06-22T16:53:13.747Z",
        "sub": [
          {
            "planet": "mars",
            "start": "2139-06-22T22:53:13.747Z",
            "end": "2139-11-19T02:20:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2139-11-19T02:20:13.747Z",
            "end": "2140-12-06T14:38:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2140-12-06T14:38:13.747Z",
            "end": "2141-11-12T12:14:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2141-11-12T12:14:13.747Z",
            "end": "2142-12-22T07:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2142-12-22T07:53:13.747Z",
            "end": "2143-12-19T12:50:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2143-12-19T12:50:13.747Z",
            "end": "2144-05-16T16:17:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2144-05-16T16:17:13.747Z",
            "end": "2145-07-16T19:17:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2145-07-16T19:17:13.747Z",
            "end": "2145-11-21T15:23:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2145-11-21T15:23:13.747Z",
            "end": "2146-06-22T16:53:13.747Z"
          }
        ]
      },
      {
        "planet": "rahu",
        "start": "2146-06-22T16:53:13.747Z",
        "end": "2164-06-22T04:53:13.747Z",
        "sub": [
          {
            "planet": "rahu",
            "start": "2146-06-22T16:53:13.747Z",
            "end": "2149-03-04T21:05:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2149-03-04T21:05:13.747Z",
            "end": "2151-07-29T11:29:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2151-07-29T11:29:13.747Z",
            "end": "2154-06-04T10:35:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2154-06-04T10:35:13.747Z",
            "end": "2156-12-21T19:53:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2156-12-21T19:53:13.747Z",
            "end": "2158-01-09T08:11:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2158-01-09T08:11:13.747Z",
            "end": "2161-01-09T02:11:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2161-01-09T02:11:13.747Z",
            "end": "2161-12-03T19:35:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2161-12-03T19:35:13.747Z",
            "end": "2163-06-04T16:35:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2163-06-04T16:35:13.747Z",
            "end": "2164-06-22T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "jupiter",
        "start": "2164-06-22T04:53:13.747Z",
        "end": "2180-06-22T04:53:13.747Z",
        "sub": [
          {
            "planet": "jupiter",
            "start": "2164-06-22T04:53:13.747Z",
            "end": "2166-08-10T09:41:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2166-08-10T09:41:13.747Z",
            "end": "2169-02-20T16:53:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2169-02-20T16:53:13.747Z",
            "end": "2171-05-29T14:29:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2171-05-29T14:29:13.747Z",
            "end": "2172-05-04T12:05:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2172-05-04T12:05:13.747Z",
            "end": "2175-01-03T12:05:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2175-01-03T12:05:13.747Z",
            "end": "2175-10-22T16:53:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2175-10-22T16:53:13.747Z",
            "end": "2177-02-20T16:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2177-02-20T16:53:13.747Z",
            "end": "2178-01-27T14:29:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2178-01-27T14:29:13.747Z",
            "end": "2180-06-22T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "saturn",
        "start": "2180-06-22T04:53:13.747Z",
        "end": "2199-06-22T22:53:13.747Z",
        "sub": [
          {
            "planet": "saturn",
            "start": "2180-06-22T04:53:13.747Z",
            "end": "2183-06-25T23:56:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2183-06-25T23:56:13.747Z",
            "end": "2186-03-05T03:05:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2186-03-05T03:05:13.747Z",
            "end": "2187-04-13T22:44:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2187-04-13T22:44:13.747Z",
            "end": "2190-06-13T13:44:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2190-06-13T13:44:13.747Z",
            "end": "2191-05-26T13:26:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2191-05-26T13:26:13.747Z",
            "end": "2192-12-24T20:56:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2192-12-24T20:56:13.747Z",
            "end": "2194-02-02T16:35:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2194-02-02T16:35:13.747Z",
            "end": "2196-12-09T15:41:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2196-12-09T15:41:13.747Z",
            "end": "2199-06-22T22:53:13.747Z"
          }
        ]
      },
      {
        "planet": "mercury",
        "start": "2199-06-22T22:53:13.747Z",
        "end": "2216-06-23T04:53:13.747Z",
        "sub": [
          {
            "planet": "mercury",
            "start": "2199-06-22T22:53:13.747Z",
            "end": "2201-11-19T14:20:13.747Z"
          },
          {
            "planet": "ketu",
            "start": "2201-11-19T14:20:13.747Z",
            "end": "2202-11-16T19:17:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2202-11-16T19:17:13.747Z",
            "end": "2205-09-16T16:17:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2205-09-16T16:17:13.747Z",
            "end": "2206-07-24T03:23:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2206-07-24T03:23:13.747Z",
            "end": "2207-12-23T13:53:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2207-12-23T13:53:13.747Z",
            "end": "2208-12-19T18:50:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2208-12-19T18:50:13.747Z",
            "end": "2211-07-09T04:08:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2211-07-09T04:08:13.747Z",
            "end": "2213-10-14T01:44:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2213-10-14T01:44:13.747Z",
            "end": "2216-06-23T04:53:13.747Z"
          }
        ]
      },
      {
        "planet": "ketu",
        "start": "2216-06-23T04:53:13.747Z",
        "end": "2223-06-23T22:53:13.747Z",
        "sub": [
          {
            "planet": "ketu",
            "start": "2216-06-23T04:53:13.747Z",
            "end": "2216-11-19T08:20:13.747Z"
          },
          {
            "planet": "venus",
            "start": "2216-11-19T08:20:13.747Z",
            "end": "2218-01-19T11:20:13.747Z"
          },
          {
            "planet": "sun",
            "start": "2218-01-19T11:20:13.747Z",
            "end": "2218-05-27T07:26:13.747Z"
          },
          {
            "planet": "moon",
            "start": "2218-05-27T07:26:13.747Z",
            "end": "2218-12-26T08:56:13.747Z"
          },
          {
            "planet": "mars",
            "start": "2218-12-26T08:56:13.747Z",
            "end": "2219-05-24T12:23:13.747Z"
          },
          {
            "planet": "rahu",
            "start": "2219-05-24T12:23:13.747Z",
            "end": "2220-06-11T00:41:13.747Z"
          },
          {
            "planet": "jupiter",
            "start": "2220-06-11T00:41:13.747Z",
            "end": "2221-05-17T22:17:13.747Z"
          },
          {
            "planet": "saturn",
            "start": "2221-05-17T22:17:13.747Z",
            "end": "2222-06-26T17:56:13.747Z"
          },
          {
            "planet": "mercury",
            "start": "2222-06-26T17:56:13.747Z",
            "end": "2223-06-23T22:53:13.747Z"
          }
        ]
      }
    ],
    "basis": {
      "moon_longitude": 18.09552915,
      "ayanamsa": 23.73020048,
      "nakshatra": {
        "id": "bharani",
        "number": 2,
        "lord": "venus",
        "start": 13.33333333,
        "end": 26.66666667
      },
      "elapsed_fraction": 0.3571646866,
      "remaining_fraction": 0.6428353134,
      "balance": {
        "planet": "venus",
        "years": 12.8567062688,
        "days": 4695.91196467
      },
      "year_days": 365.25,
      "birth": "1990-08-13T01:00:00.000Z"
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  },
  "depth": 2
}

Running Maha → Antar → Pratyantar → Sookshma

POST/v1/dasha/vimshottari/current

2 credits · Secret key (test or live) · getCurrentDasha · Page for this operation

data.basis gives the inputs of the balance at birth, as on /v1/dasha/vimshottari; options.dasha_year sets the year length.

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
at string (date-time)
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
- tone string
  descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
  one of default, descriptive · default "default"
- dasha_year number
  Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
  one of 365.25, 365.2422, 360 · default 365.25
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

at string (date-time) required
mahadasha DashaPeriod required
- planet string required
- start string (date-time) required
- end string (date-time) required
antardasha DashaPeriod required
- planet string required
- start string (date-time) required
- end string (date-time) required
pratyantardasha DashaPeriod required
- planet string required
- start string (date-time) required
- end string (date-time) required
sookshma DashaPeriod required
- planet string required
- start string (date-time) required
- end string (date-time) required
prana DashaPeriod required
- planet string required
- start string (date-time) required
- end string (date-time) required
basis DashaBasis required
- moon_longitude number required
  The sidereal Moon at the birth instant, full precision (degrees).
- ayanamsa number required
  The ayanamsa at the birth instant (degrees), of the system in meta.ayanamsa (Lahiri unless options.ayanamsa).
- nakshatra object required
  Fields
  - id string required
  - number integer required
    ≥ 1 · ≤ 27
  - lord string required
  - start number required
  - end number required
- elapsed_fraction number required
  ≥ 0 · ≤ 1
- remaining_fraction number required
  ≥ 0 · ≤ 1
- balance object required
  Fields
  - planet string required
  - years number required
  - days number required
- year_days number required
- birth string (date-time) required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/dasha/vimshottari/current' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"at":"2026-10-02T00:00:00Z"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/dasha/vimshottari/current", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "at": "2026-10-02T00:00:00Z"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "at": "2026-10-02T00:00:00Z",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/dasha/vimshottari/current",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/dasha/vimshottari/current');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"at":"2026-10-02T00:00:00Z"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,607 characters

{
  "data": {
    "at": "2026-10-02T00:00:00.000Z",
    "mahadasha": {
      "planet": "rahu",
      "start": "2026-06-21T16:53:13.747Z",
      "end": "2044-06-21T04:53:13.747Z"
    },
    "antardasha": {
      "planet": "rahu",
      "start": "2026-06-21T16:53:13.747Z",
      "end": "2029-03-03T21:05:13.747Z"
    },
    "pratyantardasha": {
      "planet": "rahu",
      "start": "2026-06-21T16:53:13.747Z",
      "end": "2026-11-16T15:07:01.747Z"
    },
    "sookshma": {
      "planet": "venus",
      "start": "2026-09-24T14:57:05.047Z",
      "end": "2026-10-19T06:39:23.047Z"
    },
    "prana": {
      "planet": "moon",
      "start": "2026-09-29T23:09:14.947Z",
      "end": "2026-10-02T00:27:46.447Z"
    },
    "basis": {
      "moon_longitude": 18.09552915,
      "ayanamsa": 23.73020048,
      "nakshatra": {
        "id": "bharani",
        "number": 2,
        "lord": "venus",
        "start": 13.33333333,
        "end": 26.66666667
      },
      "elapsed_fraction": 0.3571646866,
      "remaining_fraction": 0.6428353134,
      "balance": {
        "planet": "venus",
        "years": 12.8567062688,
        "days": 4695.91196467
      },
      "year_days": 365.25,
      "birth": "1990-08-13T01:00:00.000Z"
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  },
  "at": "2026-10-02T00:00:00Z"
}

Yogini dasha periods

POST/v1/dasha/yogini

2 credits · Secret key (test or live) · getYogini · Page for this operation

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
- tone string
  descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
  one of default, descriptive · default "default"
- dasha_year number
  Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
  one of 365.25, 365.2422, 360 · default 365.25
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

current object or null required
One of:
1. object
  Fields
  - yogini string required
  - lord string required
  - years number required
  - start string (date-time) required
  - end string (date-time) required
2. null
timeline array of object required
- yogini string required
- lord string required
- years number required
- start string (date-time) required
- end string (date-time) required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/dasha/yogini' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/dasha/yogini", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/dasha/yogini",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/dasha/yogini');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 3,432 characters

{
  "data": {
    "current": {
      "yogini": "bhadrika",
      "lord": "mercury",
      "years": 5,
      "start": "2024-10-29T18:28:18.436Z",
      "end": "2029-10-30T00:28:18.436Z"
    },
    "timeline": [
      {
        "yogini": "bhadrika",
        "lord": "mercury",
        "years": 3.21,
        "start": "1990-08-13T01:00:00.000Z",
        "end": "1993-10-30T00:28:18.436Z"
      },
      {
        "yogini": "ulka",
        "lord": "saturn",
        "years": 6,
        "start": "1993-10-30T00:28:18.436Z",
        "end": "1999-10-30T12:28:18.436Z"
      },
      {
        "yogini": "siddha",
        "lord": "venus",
        "years": 7,
        "start": "1999-10-30T12:28:18.436Z",
        "end": "2006-10-30T06:28:18.436Z"
      },
      {
        "yogini": "sankata",
        "lord": "rahu",
        "years": 8,
        "start": "2006-10-30T06:28:18.436Z",
        "end": "2014-10-30T06:28:18.436Z"
      },
      {
        "yogini": "mangala",
        "lord": "moon",
        "years": 1,
        "start": "2014-10-30T06:28:18.436Z",
        "end": "2015-10-30T12:28:18.436Z"
      },
      {
        "yogini": "pingala",
        "lord": "sun",
        "years": 2,
        "start": "2015-10-30T12:28:18.436Z",
        "end": "2017-10-30T00:28:18.436Z"
      },
      {
        "yogini": "dhanya",
        "lord": "jupiter",
        "years": 3,
        "start": "2017-10-30T00:28:18.436Z",
        "end": "2020-10-29T18:28:18.436Z"
      },
      {
        "yogini": "bhramari",
        "lord": "mars",
        "years": 4,
        "start": "2020-10-29T18:28:18.436Z",
        "end": "2024-10-29T18:28:18.436Z"
      },
      {
        "yogini": "bhadrika",
        "lord": "mercury",
        "years": 5,
        "start": "2024-10-29T18:28:18.436Z",
        "end": "2029-10-30T00:28:18.436Z"
      },
      {
        "yogini": "ulka",
        "lord": "saturn",
        "years": 6,
        "start": "2029-10-30T00:28:18.436Z",
        "end": "2035-10-30T12:28:18.436Z"
      },
      {
        "yogini": "siddha",
        "lord": "venus",
        "years": 7,
        "start": "2035-10-30T12:28:18.436Z",
        "end": "2042-10-30T06:28:18.436Z"
      },
      {
        "yogini": "sankata",
        "lord": "rahu",
        "years": 8,
        "start": "2042-10-30T06:28:18.436Z",
        "end": "2050-10-30T06:28:18.436Z"
      },
      {
        "yogini": "mangala",
        "lord": "moon",
        "years": 1,
        "start": "2050-10-30T06:28:18.436Z",
        "end": "2051-10-30T12:28:18.436Z"
      },
      {
        "yogini": "pingala",
        "lord": "sun",
        "years": 2,
        "start": "2051-10-30T12:28:18.436Z",
        "end": "2053-10-30T00:28:18.436Z"
      },
      {
        "yogini": "dhanya",
        "lord": "jupiter",
        "years": 3,
        "start": "2053-10-30T00:28:18.436Z",
        "end": "2056-10-29T18:28:18.436Z"
      },
      {
        "yogini": "bhramari",
        "lord": "mars",
        "years": 4,
        "start": "2056-10-29T18:28:18.436Z",
        "end": "2060-10-29T18:28:18.436Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  }
}

Jaimini Chara dasha and the karakas

POST/v1/dasha/chara

2 credits · Secret key (test or live) · getChara · Page for this operation

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
- tone string
  descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
  one of default, descriptive · default "default"
- dasha_year number
  Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
  one of 365.25, 365.2422, 360 · default 365.25
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

direction string required
one of direct, reverse
current object or null required
One of:
1. object
  Fields
  - sign string required
  - lord string required
  - years number required
  - start string (date-time) required
  - end string (date-time) required
2. null
timeline array of object required
- sign string required
- lord string required
- years number required
- start string (date-time) required
- end string (date-time) required
karakas array of object required
- role string required
- planet string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/dasha/chara' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/dasha/chara", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/dasha/chara",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/dasha/chara');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 3,270 characters

{
  "data": {
    "direction": "direct",
    "current": {
      "sign": "aquarius",
      "lord": "saturn",
      "years": 10,
      "start": "2026-08-13T01:00:00.000Z",
      "end": "2036-08-12T13:00:00.000Z"
    },
    "timeline": [
      {
        "sign": "leo",
        "lord": "sun",
        "years": 1,
        "start": "1990-08-13T01:00:00.000Z",
        "end": "1991-08-13T07:00:00.000Z"
      },
      {
        "sign": "virgo",
        "lord": "mercury",
        "years": 11,
        "start": "1991-08-13T07:00:00.000Z",
        "end": "2002-08-13T01:00:00.000Z"
      },
      {
        "sign": "libra",
        "lord": "venus",
        "years": 3,
        "start": "2002-08-13T01:00:00.000Z",
        "end": "2005-08-12T19:00:00.000Z"
      },
      {
        "sign": "scorpio",
        "lord": "mars",
        "years": 5,
        "start": "2005-08-12T19:00:00.000Z",
        "end": "2010-08-13T01:00:00.000Z"
      },
      {
        "sign": "sagittarius",
        "lord": "jupiter",
        "years": 5,
        "start": "2010-08-13T01:00:00.000Z",
        "end": "2015-08-13T07:00:00.000Z"
      },
      {
        "sign": "capricorn",
        "lord": "saturn",
        "years": 11,
        "start": "2015-08-13T07:00:00.000Z",
        "end": "2026-08-13T01:00:00.000Z"
      },
      {
        "sign": "aquarius",
        "lord": "saturn",
        "years": 10,
        "start": "2026-08-13T01:00:00.000Z",
        "end": "2036-08-12T13:00:00.000Z"
      },
      {
        "sign": "pisces",
        "lord": "jupiter",
        "years": 8,
        "start": "2036-08-12T13:00:00.000Z",
        "end": "2044-08-12T13:00:00.000Z"
      },
      {
        "sign": "aries",
        "lord": "mars",
        "years": 12,
        "start": "2044-08-12T13:00:00.000Z",
        "end": "2056-08-12T13:00:00.000Z"
      },
      {
        "sign": "taurus",
        "lord": "venus",
        "years": 10,
        "start": "2056-08-12T13:00:00.000Z",
        "end": "2066-08-13T01:00:00.000Z"
      },
      {
        "sign": "gemini",
        "lord": "mercury",
        "years": 2,
        "start": "2066-08-13T01:00:00.000Z",
        "end": "2068-08-12T13:00:00.000Z"
      },
      {
        "sign": "cancer",
        "lord": "moon",
        "years": 9,
        "start": "2068-08-12T13:00:00.000Z",
        "end": "2077-08-12T19:00:00.000Z"
      }
    ],
    "karakas": [
      {
        "role": "atmakaraka",
        "planet": "sun"
      },
      {
        "role": "amatyakaraka",
        "planet": "saturn"
      },
      {
        "role": "bhratrikaraka",
        "planet": "mars"
      },
      {
        "role": "matrikaraka",
        "planet": "mercury"
      },
      {
        "role": "putrakaraka",
        "planet": "moon"
      },
      {
        "role": "gnatikaraka",
        "planet": "venus"
      },
      {
        "role": "darakaraka",
        "planet": "jupiter"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  }
}