Skip to content
Occult API
POST/api/astro/dasha/current/1 credit

Current dasha

Which dasha period is running right now, at every level. The question people actually ask of a dasha. Returns the chain from mahadasha down — "Jupiter / Ketu / Mercury" — each level with its start, its end, how far through it you are as a percentage, and how many days remain. The timeline endpoints cannot answer this without you fetching the whole tree, recursing it and comparing dates yourself. Defaults to Vimshottari and to now; pass `as_of` for any other moment and `system` for any of the thirty.

https://yogataraapi.prahlad.app/api/astro/dasha/current/
Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

FieldTypeRequiredNotes
latitudenumber (double)required

Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first.

min -90 · max 90

longitudenumber (double)required

Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China.

min -180 · max 180

as_ofstring (date-time)optional

The moment to report on. Defaults to now (UTC).

dasha_directionstringoptional
forwardbackward
dasha_startstringoptional

Which cycle the timeline opens on.

currentnextprevious
date_timestring (date-time)optional

The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.

datetimestring (date-time)optional

The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC. Same meaning as date_time, which other endpoints call the same thing by a different name.

days_in_yearnumber (double)optional

Year length the periods are measured in. 360 for the classical savana year, 365.25 for the Julian year.

min 360 · max 365.256364

levelsintegeroptional

How deep to nest: 1 mahadasha only, 2 adds antardasha, 3 adds pratyantardasha. Capped at 4 because the response grows roughly tenfold per level.

min 1 · max 4

nodestringoptional

Lunar node model. Required by the rashi parent, which does not default it; defaulted here.

truemean
systemstringoptional

Which system to read. Defaults to Vimshottari.

timezone_as_floatnumber (double)optional

UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset.

min -12 · max 14

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/dasha/current/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"levels":3,"system":"Vimshottari"}'

Response

{
  "data": {
    "system": "Vimshottari",
    "engine_id": "VimshottariDasha",
    "family": "nakshatra",
    "lord_type": "planet",
    "levels": 3,
    "level_names": [
      "mahadasha",
      "antardasha",
      "pratyantardasha"
    ],
    "cycle_years": 120,
    "conditional": false,
    "as_of": "2026-09-09T09:10:36.588036+00:00",
    "running": true,
    "chain": [
      {
        "level": "mahadasha",
        "lord": "jupiter",
        "start": "2018-12-03 16:34:05.606114+00:00",
        "end": "2034-12-03 16:34:05.606114+00:00",
        "elapsed_percent": 48.54,
        "remaining_days": 3007.308
      },
      {
        "level": "antardasha",
        "lord": "ketu",
        "start": "2025-11-09 02:10:05.606114+00:00",
        "end": "2026-10-15 23:46:05.606114+00:00",
        "elapsed_percent": 89.261,
        "remaining_days": 36.608
      },
      {
        "level": "pratyantardasha",
        "lord": "mercury",
        "start": "2026-08-27 22:10:05.606114+00:00",
        "end": "2026-10-15 02:10:05.606114+00:00",
        "elapsed_percent": 25.866,
        "remaining_days": 35.708
      }
    ],
    "summary": "Jupiter / Ketu / Mercury",
    "note": null,
    "boundary_note": null
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.