POST/v1/astro/yogini

Yogini Dasha

Computes Yogini Dasha periods for a given birth chart. What is Yogini Dasha? Yogini Dasha is a Nakshatra-based dasha system using 8 Yoginis, each ruled by a planet. The total cycle is 36 years. It is considered highly accurate for timing events in the near term and is widely used alongside Vimshottari. The 8 Yoginis and their durations: - Mangala (Moon) — 1 year - Pingala (Sun) — 2 years - Dhanya (Jupiter) — 3 years - Bhramari (Mars) — 4 years - Bhadrika (Mercury) — 5 years - Ulka (Saturn) — 6 years - Siddha (Venus) — 7 years - Sankata (Rahu) — 8 years Starting Yogini is determined by the Moon's Nakshatra at birth. Levels: - levels: 1 — returns Maha Dasha periods only - levels: 2 — returns Maha Dasha with Antar Dasha sub-periods (default) Date format: All dates are returned in DD/MM/YYYY format. Ayanamsa: Default is Lahiri.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

levelsoptional

integer

Depth of sub-periods to return. 1 returns Maha Dashas only. 2 returns Maha and Antar Dashas. Maximum is 2.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.periods

object

data.periods.root

array[object]

data.periods.root[].yogini

string

Name of the Yogini ruling this period, e.g. Mangala, Pingala, Dhanya

data.periods.root[].planet

string

Planetary lord of this Yogini

data.periods.root[].start_jd

number

Start of period as Julian Day number

data.periods.root[].end_jd

number

End of period as Julian Day number

data.periods.root[].start_date

string

Start date in DD/MM/YYYY format

data.periods.root[].end_date

string

End date in DD/MM/YYYY format

data.periods.root[].sub

array[object] | null

Sub-periods (Antar Dasha). Present only when levels=2.

data.birth_time_provided

boolean

Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Ashtottari Dasha
• Jaimini Char Dasha
• Dasha-Transit Correlation
• Vimshottari Dasha

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/yogini" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.advanced_api import AdvancedApi
from asterwise.models.yogini_request import YoginiRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = YoginiRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AdvancedApi(client)
    result = api.yogini_dasha(yogini_request=request)
    print(result)

TypeScript

import { createClient, createConfig, yoginiDasha } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await yoginiDasha({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "periods": {
      "root": [
        {
          "yogini": "Pingala",
          "planet": "Sun",
          "start_jd": 2446381.5520833335,
          "end_jd": 2446481.3399304324,
          "start_date": "12/11/1985",
          "end_date": "19/02/1986",
          "sub": [
            {
              "yogini": "Pingala",
              "planet": "Sun",
              "start_jd": 2446381.5520833335,
              "end_jd": 2446387.0958526167,
              "start_date": "12/11/1985",
              "end_date": "17/11/1985"
            },
            {
              "yogini": "Dhanya",
              "planet": "Jupiter",
              "start_jd": 2446387.0958526167,
              "end_jd": 2446395.4115065415,
              "start_date": "17/11/1985",
              "end_date": "25/11/1985"
            },
            "... and 6 more items"
          ]
        },
        {
          "yogini": "Dhanya",
          "planet": "Jupiter",
          "start_jd": 2446481.3399304324,
          "end_jd": 2447577.1090104324,
          "start_date": "19/02/1986",
          "end_date": "19/02/1989",
          "sub": [
            {
              "yogini": "Dhanya",
              "planet": "Jupiter",
              "start_jd": 2446481.3399304324,
              "end_jd": 2446572.6540204324,
              "start_date": "19/02/1986",
              "end_date": "22/05/1986"
            },
            {
              "yogini": "Bhramari",
              "planet": "Mars",
              "start_jd": 2446572.6540204324,
              "end_jd": 2446694.406140432,
              "start_date": "22/05/1986",
              "end_date": "20/09/1986"
            },
            "... and 6 more items"
          ]
        },
        "... and 6 more items"
      ]
    },
    "birth_time_provided": true
  }
}