POST/v1/astro/dasha-transits

Dasha-Transit Correlation

Correlates active Vimshottari Dasha lords (maha, antar, pratyantar) with current planetary transits. Returns conjunction and aspect correlations scored by strength, and highlights periods of significance. Request JSON follows BirthInput plus optional target_date, target_time, target_timezone for the analysis moment: name, date, time, location or latitude/longitude/timezone, ayanamsa.

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

target_dateoptional

string | null

YYYY-MM-DD. Defaults to today.

target_timeoptional

string | null

HH:MM. Defaults to noon.

target_timezoneoptional

string | null

Timezone for target date.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.target_date

string

data.active_dasha

object

data.transit_positions

object

data.correlations

array[object]

data.periods_of_significance

array[object]

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
• Vimshottari Dasha
• Yogini Dasha

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/dasha-transits" \
  -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.astrology_api import AstrologyApi
from asterwise.models.dasha_transits_request import DashaTransitsRequest

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

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

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.dasha_transits(dasha_transits_request=request)
    print(result)

TypeScript

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

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

const result = await dashaTransits({
  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": {
    "target_date": "2026-05-28",
    "active_dasha": {
      "start_date": "2023-04",
      "end_date": "2040-04",
      "maha": {
        "planet": "Mercury",
        "start_date": "2023-04",
        "end_date": "2040-04"
      },
      "antar": {
        "planet": "Ketu",
        "start_date": "2025-09",
        "end_date": "2026-09"
      },
      "pratyantar": {
        "planet": "Jupiter",
        "start_date": "2026-04",
        "end_date": "2026-06"
      }
    },
    "transit_positions": {
      "Sun": {
        "rashi_index": 1,
        "rashi": "Vrishabha",
        "is_retrograde": false,
        "house_from_moon": 8,
        "house_from_lagna": 10
      },
      "Moon": {
        "rashi_index": 6,
        "rashi": "Tula",
        "is_retrograde": false,
        "house_from_moon": 1,
        "house_from_lagna": 3
      },
      "Mars": {
        "rashi_index": 0,
        "rashi": "Mesha",
        "is_retrograde": false,
        "house_from_moon": 7,
        "house_from_lagna": 9
      },
      "Mercury": {
        "rashi_index": 1,
        "rashi": "Vrishabha",
        "is_retrograde": false,
        "house_from_moon": 8,
        "house_from_lagna": 10
      },
      "Jupiter": {
        "rashi_index": 2,
        "rashi": "Mithuna",
        "is_retrograde": false,
        "house_from_moon": 9,
        "house_from_lagna": 11
      },
      "Venus": {
        "rashi_index": 2,
        "rashi": "Mithuna",
        "is_retrograde": false,
        "house_from_moon": 9,
        "house_from_lagna": 11
      },
      "Saturn": {
        "rashi_index": 11,
        "rashi": "Meena",
        "is_retrograde": false,
        "house_from_moon": 6,
        "house_from_lagna": 8
      },
      "Rahu": {
        "rashi_index": 10,
        "rashi": "Kumbha",
        "is_retrograde": true,
        "house_from_moon": 5,
        "house_from_lagna": 7
      },
      "Ketu": {
        "rashi_index": 4,
        "rashi": "Simha",
        "is_retrograde": false,
        "house_from_moon": 11,
        "house_from_lagna": 1
      }
    },
    "correlations": [
      {
        "dasha_level": "antar",
        "dasha_lord": "Ketu",
        "transit_planet": "Moon",
        "aspect_type": "conjunction",
        "score": 3,
        "natal_rashi": "Tula",
        "transit_rashi": "Tula",
        "is_retrograde": false,
        "significance": "High — Moon influencing Ketu (antar lord)"
      },
      {
        "dasha_level": "antar",
        "dasha_lord": "Ketu",
        "transit_planet": "Mars",
        "aspect_type": "opposition",
        "score": 2,
        "natal_rashi": "Tula",
        "transit_rashi": "Mesha",
        "is_retrograde": false,
        "significance": "Moderate — Mars influencing Ketu (antar lord)"
      },
      "... and 5 more items"
    ],
    "periods_of_significance": [
      {
        "dasha_level": "antar",
        "dasha_lord": "Ketu",
        "transit_planet": "Moon",
        "aspect_type": "conjunction",
        "score": 3,
        "natal_rashi": "Tula",
        "transit_rashi": "Tula",
        "is_retrograde": false,
        "significance": "High — Moon influencing Ketu (antar lord)"
      },
      {
        "dasha_level": "antar",
        "dasha_lord": "Ketu",
        "transit_planet": "Mars",
        "aspect_type": "opposition",
        "score": 2,
        "natal_rashi": "Tula",
        "transit_rashi": "Mesha",
        "is_retrograde": false,
        "significance": "Moderate — Mars influencing Ketu (antar lord)"
      },
      "... and 2 more items"
    ]
  }
}