Dasha

Vimshottari periods to four levels 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

depth 5 (prana) needs from and to at most 31 days apart; every level is then limited to that range.

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

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,693 characters

{
  "data": {
    "periods": [
      {
        "planet": "venus",
        "start": "1990-08-13T00:00:00.000Z",
        "end": "2003-06-19T16:21:34.560Z",
        "sub": [
          {
            "planet": "venus",
            "start": "1990-08-13T00:00:00.000Z",
            "end": "1992-10-03T08:46:19.200Z"
          },
          {
            "planet": "sun",
            "start": "1992-10-03T08:46:19.200Z",
            "end": "1993-05-26T05:18:36.000Z"
          },
          {
            "planet": "moon",
            "start": "1993-05-26T05:18:36.000Z",
            "end": "1994-06-21T09:41:45.600Z"
          },
          {
            "planet": "mars",
            "start": "1994-06-21T09:41:45.600Z",
            "end": "1995-03-22T08:11:45.600Z"
          },
          {
            "planet": "rahu",
            "start": "1995-03-22T08:11:45.600Z",
            "end": "1997-02-23T13:02:38.400Z"
          },
          {
            "planet": "jupiter",
            "start": "1997-02-23T13:02:38.400Z",
            "end": "1998-11-11T05:12:07.200Z"
          },
          {
            "planet": "saturn",
            "start": "1998-11-11T05:12:07.200Z",
            "end": "2000-11-23T12:00:43.200Z"
          },
          {
            "planet": "mercury",
            "start": "2000-11-23T12:00:43.200Z",
            "end": "2002-09-19T14:53:52.800Z"
          },
          {
            "planet": "ketu",
            "start": "2002-09-19T14:53:52.800Z",
            "end": "2003-06-20T13:23:52.800Z"
          }
        ]
      },
      {
        "planet": "sun",
        "start": "2003-06-19T16:21:34.560Z",
        "end": "2009-06-19T04:21:34.560Z",
        "sub": [
          {
            "planet": "sun",
            "start": "2003-06-19T16:21:34.560Z",
            "end": "2003-10-07T06:09:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2003-10-07T06:09:34.560Z",
            "end": "2004-04-06T21:09:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2004-04-06T21:09:34.560Z",
            "end": "2004-08-12T17:15:34.560Z"
          },
          {
            "planet": "rahu",
            "start": "2004-08-12T17:15:34.560Z",
            "end": "2005-07-07T10:39:34.560Z"
          },
          {
            "planet": "jupiter",
            "start": "2005-07-07T10:39:34.560Z",
            "end": "2006-04-25T15:27:34.560Z"
          },
          {
            "planet": "saturn",
            "start": "2006-04-25T15:27:34.560Z",
            "end": "2007-04-07T15:09:34.560Z"
          },
          {
            "planet": "mercury",
            "start": "2007-04-07T15:09:34.560Z",
            "end": "2008-02-12T02:15:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2008-02-12T02:15:34.560Z",
            "end": "2008-06-18T22:21:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2008-06-18T22:21:34.560Z",
            "end": "2009-06-19T04:21:34.560Z"
          }
        ]
      },
      {
        "planet": "moon",
        "start": "2009-06-19T04:21:34.560Z",
        "end": "2019-06-19T16:21:34.560Z",
        "sub": [
          {
            "planet": "moon",
            "start": "2009-06-19T04:21:34.560Z",
            "end": "2010-04-19T10:26:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2010-04-19T10:26:15.360Z",
            "end": "2010-11-18T09:00:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2010-11-18T09:00:56.160Z",
            "end": "2012-05-19T06:00:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2012-05-19T06:00:56.160Z",
            "end": "2013-09-18T03:05:36.960Z"
          },
          {
            "planet": "saturn",
            "start": "2013-09-18T03:05:36.960Z",
            "end": "2015-04-19T07:40:17.760Z"
          },
          {
            "planet": "mercury",
            "start": "2015-04-19T07:40:17.760Z",
            "end": "2016-09-17T21:05:36.960Z"
          },
          {
            "planet": "ketu",
            "start": "2016-09-17T21:05:36.960Z",
            "end": "2017-04-18T19:40:17.760Z"
          },
          {
            "planet": "venus",
            "start": "2017-04-18T19:40:17.760Z",
            "end": "2018-12-18T16:35:36.960Z"
          },
          {
            "planet": "sun",
            "start": "2018-12-18T16:35:36.960Z",
            "end": "2019-06-19T07:35:36.960Z"
          }
        ]
      },
      {
        "planet": "mars",
        "start": "2019-06-19T16:21:34.560Z",
        "end": "2026-06-19T10:21:34.560Z",
        "sub": [
          {
            "planet": "mars",
            "start": "2019-06-19T16:21:34.560Z",
            "end": "2019-11-15T16:53:15.360Z"
          },
          {
            "planet": "rahu",
            "start": "2019-11-15T16:53:15.360Z",
            "end": "2020-12-03T05:11:15.360Z"
          },
          {
            "planet": "jupiter",
            "start": "2020-12-03T05:11:15.360Z",
            "end": "2021-11-08T23:51:56.160Z"
          },
          {
            "planet": "saturn",
            "start": "2021-11-08T23:51:56.160Z",
            "end": "2022-12-18T16:35:36.960Z"
          },
          {
            "planet": "mercury",
            "start": "2022-12-18T16:35:36.960Z",
            "end": "2023-12-16T00:27:56.160Z"
          },
          {
            "planet": "ketu",
            "start": "2023-12-16T00:27:56.160Z",
            "end": "2024-05-13T00:59:36.960Z"
          },
          {
            "planet": "venus",
            "start": "2024-05-13T00:59:36.960Z",
            "end": "2025-07-13T06:54:56.160Z"
          },
          {
            "planet": "sun",
            "start": "2025-07-13T06:54:56.160Z",
            "end": "2025-11-18T03:00:56.160Z"
          },
          {
            "planet": "moon",
            "start": "2025-11-18T03:00:56.160Z",
            "end": "2026-06-19T01:35:36.960Z"
          }
        ]
      },
      {
        "planet": "rahu",
        "start": "2026-06-19T10:21:34.560Z",
        "end": "2044-06-18T22:21:34.560Z",
        "sub": [
          {
            "planet": "rahu",
            "start": "2026-06-19T10:21:34.560Z",
            "end": "2029-03-01T14:33:34.560Z"
          },
          {
            "planet": "jupiter",
            "start": "2029-03-01T14:33:34.560Z",
            "end": "2031-07-26T04:57:34.560Z"
          },
          {
            "planet": "saturn",
            "start": "2031-07-26T04:57:34.560Z",
            "end": "2034-06-01T04:03:34.560Z"
          },
          {
            "planet": "mercury",
            "start": "2034-06-01T04:03:34.560Z",
            "end": "2036-12-18T13:21:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2036-12-18T13:21:34.560Z",
            "end": "2038-01-06T01:39:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2038-01-06T01:39:34.560Z",
            "end": "2041-01-05T19:39:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2041-01-05T19:39:34.560Z",
            "end": "2041-11-30T13:03:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2041-11-30T13:03:34.560Z",
            "end": "2043-06-01T10:03:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2043-06-01T10:03:34.560Z",
            "end": "2044-06-18T22:21:34.560Z"
          }
        ]
      },
      {
        "planet": "jupiter",
        "start": "2044-06-18T22:21:34.560Z",
        "end": "2060-06-18T22:21:34.560Z",
        "sub": [
          {
            "planet": "jupiter",
            "start": "2044-06-18T22:21:34.560Z",
            "end": "2046-08-07T00:14:15.360Z"
          },
          {
            "planet": "saturn",
            "start": "2046-08-07T00:14:15.360Z",
            "end": "2049-02-17T04:30:56.160Z"
          },
          {
            "planet": "mercury",
            "start": "2049-02-17T04:30:56.160Z",
            "end": "2051-05-26T05:02:15.360Z"
          },
          {
            "planet": "ketu",
            "start": "2051-05-26T05:02:15.360Z",
            "end": "2052-04-30T23:42:56.160Z"
          },
          {
            "planet": "venus",
            "start": "2052-04-30T23:42:56.160Z",
            "end": "2054-12-31T02:38:15.360Z"
          },
          {
            "planet": "sun",
            "start": "2054-12-31T02:38:15.360Z",
            "end": "2055-10-19T07:26:15.360Z"
          },
          {
            "planet": "moon",
            "start": "2055-10-19T07:26:15.360Z",
            "end": "2057-02-17T04:30:56.160Z"
          },
          {
            "planet": "mars",
            "start": "2057-02-17T04:30:56.160Z",
            "end": "2058-01-23T23:11:36.960Z"
          },
          {
            "planet": "rahu",
            "start": "2058-01-23T23:11:36.960Z",
            "end": "2060-06-18T13:35:36.960Z"
          }
        ]
      },
      {
        "planet": "saturn",
        "start": "2060-06-18T22:21:34.560Z",
        "end": "2079-06-19T16:21:34.560Z",
        "sub": [
          {
            "planet": "saturn",
            "start": "2060-06-18T22:21:34.560Z",
            "end": "2063-06-22T14:29:15.360Z"
          },
          {
            "planet": "mercury",
            "start": "2063-06-22T14:29:15.360Z",
            "end": "2066-03-01T20:33:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2066-03-01T20:33:34.560Z",
            "end": "2067-04-10T13:17:15.360Z"
          },
          {
            "planet": "venus",
            "start": "2067-04-10T13:17:15.360Z",
            "end": "2070-06-10T07:12:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2070-06-10T07:12:34.560Z",
            "end": "2071-05-23T06:54:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2071-05-23T06:54:34.560Z",
            "end": "2072-12-21T11:29:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2072-12-21T11:29:15.360Z",
            "end": "2074-01-30T04:12:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2074-01-30T04:12:56.160Z",
            "end": "2076-12-06T03:18:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2076-12-06T03:18:56.160Z",
            "end": "2079-06-19T07:35:36.960Z"
          }
        ]
      },
      {
        "planet": "mercury",
        "start": "2079-06-19T16:21:34.560Z",
        "end": "2096-06-18T22:21:34.560Z",
        "sub": [
          {
            "planet": "mercury",
            "start": "2079-06-19T16:21:34.560Z",
            "end": "2081-11-15T04:53:15.360Z"
          },
          {
            "planet": "ketu",
            "start": "2081-11-15T04:53:15.360Z",
            "end": "2082-11-12T12:45:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2082-11-12T12:45:34.560Z",
            "end": "2085-09-12T06:50:15.360Z"
          },
          {
            "planet": "sun",
            "start": "2085-09-12T06:50:15.360Z",
            "end": "2086-07-19T17:56:15.360Z"
          },
          {
            "planet": "moon",
            "start": "2086-07-19T17:56:15.360Z",
            "end": "2087-12-19T07:21:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2087-12-19T07:21:34.560Z",
            "end": "2088-12-15T15:13:53.760Z"
          },
          {
            "planet": "rahu",
            "start": "2088-12-15T15:13:53.760Z",
            "end": "2091-07-05T00:31:53.760Z"
          },
          {
            "planet": "jupiter",
            "start": "2091-07-05T00:31:53.760Z",
            "end": "2093-10-10T01:03:12.960Z"
          },
          {
            "planet": "saturn",
            "start": "2093-10-10T01:03:12.960Z",
            "end": "2096-06-19T07:07:32.160Z"
          }
        ]
      },
      {
        "planet": "ketu",
        "start": "2096-06-18T22:21:34.560Z",
        "end": "2103-06-20T16:21:34.560Z",
        "sub": [
          {
            "planet": "ketu",
            "start": "2096-06-18T22:21:34.560Z",
            "end": "2096-11-14T22:53:15.360Z"
          },
          {
            "planet": "venus",
            "start": "2096-11-14T22:53:15.360Z",
            "end": "2098-01-15T04:48:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2098-01-15T04:48:34.560Z",
            "end": "2098-05-23T00:54:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2098-05-23T00:54:34.560Z",
            "end": "2098-12-21T23:29:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2098-12-21T23:29:15.360Z",
            "end": "2099-05-20T00:00:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2099-05-20T00:00:56.160Z",
            "end": "2100-06-07T12:18:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2100-06-07T12:18:56.160Z",
            "end": "2101-05-14T06:59:36.960Z"
          },
          {
            "planet": "saturn",
            "start": "2101-05-14T06:59:36.960Z",
            "end": "2102-06-22T23:43:17.760Z"
          },
          {
            "planet": "mercury",
            "start": "2102-06-22T23:43:17.760Z",
            "end": "2103-06-20T07:35:36.960Z"
          }
        ]
      },
      {
        "planet": "venus",
        "start": "2103-06-20T16:21:34.560Z",
        "end": "2123-06-20T16:21:34.560Z",
        "sub": [
          {
            "planet": "venus",
            "start": "2103-06-20T16:21:34.560Z",
            "end": "2106-10-20T01:26:15.360Z"
          },
          {
            "planet": "sun",
            "start": "2106-10-20T01:26:15.360Z",
            "end": "2107-10-20T07:26:15.360Z"
          },
          {
            "planet": "moon",
            "start": "2107-10-20T07:26:15.360Z",
            "end": "2109-06-20T04:21:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2109-06-20T04:21:34.560Z",
            "end": "2110-08-20T10:16:53.760Z"
          },
          {
            "planet": "rahu",
            "start": "2110-08-20T10:16:53.760Z",
            "end": "2113-08-20T04:16:53.760Z"
          },
          {
            "planet": "jupiter",
            "start": "2113-08-20T04:16:53.760Z",
            "end": "2116-04-20T07:12:12.960Z"
          },
          {
            "planet": "saturn",
            "start": "2116-04-20T07:12:12.960Z",
            "end": "2119-06-21T01:07:32.160Z"
          },
          {
            "planet": "mercury",
            "start": "2119-06-21T01:07:32.160Z",
            "end": "2122-04-20T19:12:12.960Z"
          },
          {
            "planet": "ketu",
            "start": "2122-04-20T19:12:12.960Z",
            "end": "2123-06-21T01:07:32.160Z"
          }
        ]
      },
      {
        "planet": "sun",
        "start": "2123-06-20T16:21:34.560Z",
        "end": "2129-06-20T04:21:34.560Z",
        "sub": [
          {
            "planet": "sun",
            "start": "2123-06-20T16:21:34.560Z",
            "end": "2123-10-08T06:09:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2123-10-08T06:09:34.560Z",
            "end": "2124-04-07T21:09:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2124-04-07T21:09:34.560Z",
            "end": "2124-08-13T17:15:34.560Z"
          },
          {
            "planet": "rahu",
            "start": "2124-08-13T17:15:34.560Z",
            "end": "2125-07-08T10:39:34.560Z"
          },
          {
            "planet": "jupiter",
            "start": "2125-07-08T10:39:34.560Z",
            "end": "2126-04-26T15:27:34.560Z"
          },
          {
            "planet": "saturn",
            "start": "2126-04-26T15:27:34.560Z",
            "end": "2127-04-08T15:09:34.560Z"
          },
          {
            "planet": "mercury",
            "start": "2127-04-08T15:09:34.560Z",
            "end": "2128-02-13T02:15:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2128-02-13T02:15:34.560Z",
            "end": "2128-06-19T22:21:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2128-06-19T22:21:34.560Z",
            "end": "2129-06-20T04:21:34.560Z"
          }
        ]
      },
      {
        "planet": "moon",
        "start": "2129-06-20T04:21:34.560Z",
        "end": "2139-06-20T16:21:34.560Z",
        "sub": [
          {
            "planet": "moon",
            "start": "2129-06-20T04:21:34.560Z",
            "end": "2130-04-20T10:26:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2130-04-20T10:26:15.360Z",
            "end": "2130-11-19T09:00:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2130-11-19T09:00:56.160Z",
            "end": "2132-05-20T06:00:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2132-05-20T06:00:56.160Z",
            "end": "2133-09-19T03:05:36.960Z"
          },
          {
            "planet": "saturn",
            "start": "2133-09-19T03:05:36.960Z",
            "end": "2135-04-20T07:40:17.760Z"
          },
          {
            "planet": "mercury",
            "start": "2135-04-20T07:40:17.760Z",
            "end": "2136-09-18T21:05:36.960Z"
          },
          {
            "planet": "ketu",
            "start": "2136-09-18T21:05:36.960Z",
            "end": "2137-04-19T19:40:17.760Z"
          },
          {
            "planet": "venus",
            "start": "2137-04-19T19:40:17.760Z",
            "end": "2138-12-19T16:35:36.960Z"
          },
          {
            "planet": "sun",
            "start": "2138-12-19T16:35:36.960Z",
            "end": "2139-06-20T07:35:36.960Z"
          }
        ]
      },
      {
        "planet": "mars",
        "start": "2139-06-20T16:21:34.560Z",
        "end": "2146-06-20T10:21:34.560Z",
        "sub": [
          {
            "planet": "mars",
            "start": "2139-06-20T16:21:34.560Z",
            "end": "2139-11-16T16:53:15.360Z"
          },
          {
            "planet": "rahu",
            "start": "2139-11-16T16:53:15.360Z",
            "end": "2140-12-04T05:11:15.360Z"
          },
          {
            "planet": "jupiter",
            "start": "2140-12-04T05:11:15.360Z",
            "end": "2141-11-09T23:51:56.160Z"
          },
          {
            "planet": "saturn",
            "start": "2141-11-09T23:51:56.160Z",
            "end": "2142-12-19T16:35:36.960Z"
          },
          {
            "planet": "mercury",
            "start": "2142-12-19T16:35:36.960Z",
            "end": "2143-12-17T00:27:56.160Z"
          },
          {
            "planet": "ketu",
            "start": "2143-12-17T00:27:56.160Z",
            "end": "2144-05-14T00:59:36.960Z"
          },
          {
            "planet": "venus",
            "start": "2144-05-14T00:59:36.960Z",
            "end": "2145-07-14T06:54:56.160Z"
          },
          {
            "planet": "sun",
            "start": "2145-07-14T06:54:56.160Z",
            "end": "2145-11-19T03:00:56.160Z"
          },
          {
            "planet": "moon",
            "start": "2145-11-19T03:00:56.160Z",
            "end": "2146-06-20T01:35:36.960Z"
          }
        ]
      },
      {
        "planet": "rahu",
        "start": "2146-06-20T10:21:34.560Z",
        "end": "2164-06-19T22:21:34.560Z",
        "sub": [
          {
            "planet": "rahu",
            "start": "2146-06-20T10:21:34.560Z",
            "end": "2149-03-02T14:33:34.560Z"
          },
          {
            "planet": "jupiter",
            "start": "2149-03-02T14:33:34.560Z",
            "end": "2151-07-27T04:57:34.560Z"
          },
          {
            "planet": "saturn",
            "start": "2151-07-27T04:57:34.560Z",
            "end": "2154-06-02T04:03:34.560Z"
          },
          {
            "planet": "mercury",
            "start": "2154-06-02T04:03:34.560Z",
            "end": "2156-12-19T13:21:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2156-12-19T13:21:34.560Z",
            "end": "2158-01-07T01:39:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2158-01-07T01:39:34.560Z",
            "end": "2161-01-06T19:39:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2161-01-06T19:39:34.560Z",
            "end": "2161-12-01T13:03:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2161-12-01T13:03:34.560Z",
            "end": "2163-06-02T10:03:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2163-06-02T10:03:34.560Z",
            "end": "2164-06-19T22:21:34.560Z"
          }
        ]
      },
      {
        "planet": "jupiter",
        "start": "2164-06-19T22:21:34.560Z",
        "end": "2180-06-19T22:21:34.560Z",
        "sub": [
          {
            "planet": "jupiter",
            "start": "2164-06-19T22:21:34.560Z",
            "end": "2166-08-08T00:14:15.360Z"
          },
          {
            "planet": "saturn",
            "start": "2166-08-08T00:14:15.360Z",
            "end": "2169-02-18T04:30:56.160Z"
          },
          {
            "planet": "mercury",
            "start": "2169-02-18T04:30:56.160Z",
            "end": "2171-05-27T05:02:15.360Z"
          },
          {
            "planet": "ketu",
            "start": "2171-05-27T05:02:15.360Z",
            "end": "2172-05-01T23:42:56.160Z"
          },
          {
            "planet": "venus",
            "start": "2172-05-01T23:42:56.160Z",
            "end": "2175-01-01T02:38:15.360Z"
          },
          {
            "planet": "sun",
            "start": "2175-01-01T02:38:15.360Z",
            "end": "2175-10-20T07:26:15.360Z"
          },
          {
            "planet": "moon",
            "start": "2175-10-20T07:26:15.360Z",
            "end": "2177-02-18T04:30:56.160Z"
          },
          {
            "planet": "mars",
            "start": "2177-02-18T04:30:56.160Z",
            "end": "2178-01-24T23:11:36.960Z"
          },
          {
            "planet": "rahu",
            "start": "2178-01-24T23:11:36.960Z",
            "end": "2180-06-19T13:35:36.960Z"
          }
        ]
      },
      {
        "planet": "saturn",
        "start": "2180-06-19T22:21:34.560Z",
        "end": "2199-06-20T16:21:34.560Z",
        "sub": [
          {
            "planet": "saturn",
            "start": "2180-06-19T22:21:34.560Z",
            "end": "2183-06-23T14:29:15.360Z"
          },
          {
            "planet": "mercury",
            "start": "2183-06-23T14:29:15.360Z",
            "end": "2186-03-02T20:33:34.560Z"
          },
          {
            "planet": "ketu",
            "start": "2186-03-02T20:33:34.560Z",
            "end": "2187-04-11T13:17:15.360Z"
          },
          {
            "planet": "venus",
            "start": "2187-04-11T13:17:15.360Z",
            "end": "2190-06-11T07:12:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2190-06-11T07:12:34.560Z",
            "end": "2191-05-24T06:54:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2191-05-24T06:54:34.560Z",
            "end": "2192-12-22T11:29:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2192-12-22T11:29:15.360Z",
            "end": "2194-01-31T04:12:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2194-01-31T04:12:56.160Z",
            "end": "2196-12-07T03:18:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2196-12-07T03:18:56.160Z",
            "end": "2199-06-20T07:35:36.960Z"
          }
        ]
      },
      {
        "planet": "mercury",
        "start": "2199-06-20T16:21:34.560Z",
        "end": "2216-06-20T22:21:34.560Z",
        "sub": [
          {
            "planet": "mercury",
            "start": "2199-06-20T16:21:34.560Z",
            "end": "2201-11-17T04:53:15.360Z"
          },
          {
            "planet": "ketu",
            "start": "2201-11-17T04:53:15.360Z",
            "end": "2202-11-14T12:45:34.560Z"
          },
          {
            "planet": "venus",
            "start": "2202-11-14T12:45:34.560Z",
            "end": "2205-09-14T06:50:15.360Z"
          },
          {
            "planet": "sun",
            "start": "2205-09-14T06:50:15.360Z",
            "end": "2206-07-21T17:56:15.360Z"
          },
          {
            "planet": "moon",
            "start": "2206-07-21T17:56:15.360Z",
            "end": "2207-12-21T07:21:34.560Z"
          },
          {
            "planet": "mars",
            "start": "2207-12-21T07:21:34.560Z",
            "end": "2208-12-17T15:13:53.760Z"
          },
          {
            "planet": "rahu",
            "start": "2208-12-17T15:13:53.760Z",
            "end": "2211-07-07T00:31:53.760Z"
          },
          {
            "planet": "jupiter",
            "start": "2211-07-07T00:31:53.760Z",
            "end": "2213-10-12T01:03:12.960Z"
          },
          {
            "planet": "saturn",
            "start": "2213-10-12T01:03:12.960Z",
            "end": "2216-06-21T07:07:32.160Z"
          }
        ]
      },
      {
        "planet": "ketu",
        "start": "2216-06-20T22:21:34.560Z",
        "end": "2223-06-21T16:21:34.560Z",
        "sub": [
          {
            "planet": "ketu",
            "start": "2216-06-20T22:21:34.560Z",
            "end": "2216-11-16T22:53:15.360Z"
          },
          {
            "planet": "venus",
            "start": "2216-11-16T22:53:15.360Z",
            "end": "2218-01-17T04:48:34.560Z"
          },
          {
            "planet": "sun",
            "start": "2218-01-17T04:48:34.560Z",
            "end": "2218-05-25T00:54:34.560Z"
          },
          {
            "planet": "moon",
            "start": "2218-05-25T00:54:34.560Z",
            "end": "2218-12-23T23:29:15.360Z"
          },
          {
            "planet": "mars",
            "start": "2218-12-23T23:29:15.360Z",
            "end": "2219-05-22T00:00:56.160Z"
          },
          {
            "planet": "rahu",
            "start": "2219-05-22T00:00:56.160Z",
            "end": "2220-06-08T12:18:56.160Z"
          },
          {
            "planet": "jupiter",
            "start": "2220-06-08T12:18:56.160Z",
            "end": "2221-05-15T06:59:36.960Z"
          },
          {
            "planet": "saturn",
            "start": "2221-05-15T06:59:36.960Z",
            "end": "2222-06-23T23:43:17.760Z"
          },
          {
            "planet": "mercury",
            "start": "2222-06-23T23:43:17.760Z",
            "end": "2223-06-21T07:35:36.960Z"
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "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

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

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,090 characters

{
  "data": {
    "at": "2026-10-02T00:00:00.000Z",
    "mahadasha": {
      "planet": "rahu",
      "start": "2026-06-19T10:21:34.560Z",
      "end": "2044-06-18T22:21:34.560Z"
    },
    "antardasha": {
      "planet": "rahu",
      "start": "2026-06-19T10:21:34.560Z",
      "end": "2029-03-01T14:33:34.560Z"
    },
    "pratyantardasha": {
      "planet": "rahu",
      "start": "2026-06-19T10:21:34.560Z",
      "end": "2026-11-14T08:35:22.560Z"
    },
    "sookshma": {
      "planet": "venus",
      "start": "2026-09-22T08:33:19.224Z",
      "end": "2026-10-17T00:15:37.224Z"
    },
    "prana": {
      "planet": "rahu",
      "start": "2026-10-01T04:34:58.674Z",
      "end": "2026-10-04T21:20:19.374Z"
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "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

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
  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"
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,431 characters

{
  "data": {
    "current": {
      "yogini": "bhadrika",
      "lord": "mercury",
      "years": 5,
      "start": "2024-10-28T21:55:53.842Z",
      "end": "2029-10-29T03:01:53.842Z"
    },
    "timeline": [
      {
        "yogini": "bhadrika",
        "lord": "mercury",
        "years": 3.21,
        "start": "1990-08-13T00:00:00.000Z",
        "end": "1993-10-29T09:30:41.842Z"
      },
      {
        "yogini": "ulka",
        "lord": "saturn",
        "years": 6,
        "start": "1993-10-29T09:30:41.842Z",
        "end": "1999-10-29T20:25:53.842Z"
      },
      {
        "yogini": "siddha",
        "lord": "venus",
        "years": 7,
        "start": "1999-10-29T20:25:53.842Z",
        "end": "2006-10-29T13:10:17.842Z"
      },
      {
        "yogini": "sankata",
        "lord": "rahu",
        "years": 8,
        "start": "2006-10-29T13:10:17.842Z",
        "end": "2014-10-29T11:43:53.842Z"
      },
      {
        "yogini": "mangala",
        "lord": "moon",
        "years": 1,
        "start": "2014-10-29T11:43:53.842Z",
        "end": "2015-10-29T17:33:05.842Z"
      },
      {
        "yogini": "pingala",
        "lord": "sun",
        "years": 2,
        "start": "2015-10-29T17:33:05.842Z",
        "end": "2017-10-29T05:11:29.842Z"
      },
      {
        "yogini": "dhanya",
        "lord": "jupiter",
        "years": 3,
        "start": "2017-10-29T05:11:29.842Z",
        "end": "2020-10-28T22:39:05.842Z"
      },
      {
        "yogini": "bhramari",
        "lord": "mars",
        "years": 4,
        "start": "2020-10-28T22:39:05.842Z",
        "end": "2024-10-28T21:55:53.842Z"
      },
      {
        "yogini": "bhadrika",
        "lord": "mercury",
        "years": 5,
        "start": "2024-10-28T21:55:53.842Z",
        "end": "2029-10-29T03:01:53.842Z"
      },
      {
        "yogini": "ulka",
        "lord": "saturn",
        "years": 6,
        "start": "2029-10-29T03:01:53.842Z",
        "end": "2035-10-29T13:57:05.842Z"
      },
      {
        "yogini": "siddha",
        "lord": "venus",
        "years": 7,
        "start": "2035-10-29T13:57:05.842Z",
        "end": "2042-10-29T06:41:29.842Z"
      },
      {
        "yogini": "sankata",
        "lord": "rahu",
        "years": 8,
        "start": "2042-10-29T06:41:29.842Z",
        "end": "2050-10-29T05:15:05.842Z"
      },
      {
        "yogini": "mangala",
        "lord": "moon",
        "years": 1,
        "start": "2050-10-29T05:15:05.842Z",
        "end": "2051-10-29T11:04:17.842Z"
      },
      {
        "yogini": "pingala",
        "lord": "sun",
        "years": 2,
        "start": "2051-10-29T11:04:17.842Z",
        "end": "2053-10-28T22:42:41.842Z"
      },
      {
        "yogini": "dhanya",
        "lord": "jupiter",
        "years": 3,
        "start": "2053-10-28T22:42:41.842Z",
        "end": "2056-10-28T16:10:17.842Z"
      },
      {
        "yogini": "bhramari",
        "lord": "mars",
        "years": 4,
        "start": "2056-10-28T16:10:17.842Z",
        "end": "2060-10-28T15:27:05.842Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "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

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
  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"
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,269 characters

{
  "data": {
    "direction": "direct",
    "current": {
      "sign": "aquarius",
      "lord": "saturn",
      "years": 10,
      "start": "2026-08-12T17:31:12.000Z",
      "end": "2036-08-12T03:43:12.000Z"
    },
    "timeline": [
      {
        "sign": "leo",
        "lord": "sun",
        "years": 1,
        "start": "1990-08-13T00:00:00.000Z",
        "end": "1991-08-13T05:49:12.000Z"
      },
      {
        "sign": "virgo",
        "lord": "mercury",
        "years": 11,
        "start": "1991-08-13T05:49:12.000Z",
        "end": "2002-08-12T21:50:24.000Z"
      },
      {
        "sign": "libra",
        "lord": "venus",
        "years": 3,
        "start": "2002-08-12T21:50:24.000Z",
        "end": "2005-08-12T15:18:00.000Z"
      },
      {
        "sign": "scorpio",
        "lord": "mars",
        "years": 5,
        "start": "2005-08-12T15:18:00.000Z",
        "end": "2010-08-12T20:24:00.000Z"
      },
      {
        "sign": "sagittarius",
        "lord": "jupiter",
        "years": 5,
        "start": "2010-08-12T20:24:00.000Z",
        "end": "2015-08-13T01:30:00.000Z"
      },
      {
        "sign": "capricorn",
        "lord": "saturn",
        "years": 11,
        "start": "2015-08-13T01:30:00.000Z",
        "end": "2026-08-12T17:31:12.000Z"
      },
      {
        "sign": "aquarius",
        "lord": "saturn",
        "years": 10,
        "start": "2026-08-12T17:31:12.000Z",
        "end": "2036-08-12T03:43:12.000Z"
      },
      {
        "sign": "pisces",
        "lord": "jupiter",
        "years": 8,
        "start": "2036-08-12T03:43:12.000Z",
        "end": "2044-08-12T02:16:48.000Z"
      },
      {
        "sign": "aries",
        "lord": "mars",
        "years": 12,
        "start": "2044-08-12T02:16:48.000Z",
        "end": "2056-08-12T00:07:12.000Z"
      },
      {
        "sign": "taurus",
        "lord": "venus",
        "years": 10,
        "start": "2056-08-12T00:07:12.000Z",
        "end": "2066-08-12T10:19:12.000Z"
      },
      {
        "sign": "gemini",
        "lord": "mercury",
        "years": 2,
        "start": "2066-08-12T10:19:12.000Z",
        "end": "2068-08-11T21:57:36.000Z"
      },
      {
        "sign": "cancer",
        "lord": "moon",
        "years": 9,
        "start": "2068-08-11T21:57:36.000Z",
        "end": "2077-08-12T02:20:24.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.9.28",
    "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
    }
  }
}