Astrology

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. Aspects are Vedic graha drishti cast by the transiting planet (BPHS Ch.26): every planet aspects its 7th sign, Jupiter also its 5th and 9th, Saturn its 3rd and 10th, Mars its 4th and 8th. Each correlation gives aspect_house (the natal dasha lord's sign counted from the transiting planet, 1 = same sign) and drishti ('7th', '3rd', ...; absent for a conjunction). aspect_type is conjunction, opposition, trine (Jupiter 5th/9th), square (Saturn 10th, Mars 4th) or special (Saturn 3rd, Mars 8th). 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.

post/v1/astro/dasha-transits

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/dasha-transits
  • Auth: HTTP bearer

Request body

locationstring nullable

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

namestring

Person name associated with the birth record

datestring required

Birth date in YYYY-MM-DD format

timestring required

Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise fallback.

latitudenumber nullable

Latitude. Required if location not provided.

longitudenumber nullable

Longitude. Required if location not provided.

timezonestring nullable

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetstring nullable

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsa'lahiri' | 'raman' | 'kp' | 'tropical'

Sidereal ayanamsa mode used in calculations

target_datestring nullable

YYYY-MM-DD. Defaults to today.

target_timestring nullable

Local clock time HH:MM in target_timezone. Defaults to 12:00. Pass the user's own time so the Moon is where the user sees it.

target_timezonestring nullable

Timezone for target date.

Example request

{
  "ayanamsa": "lahiri",
  "date": "1985-11-12",
  "latitude": 19.055,
  "location": "Mumbai",
  "longitude": 72.8692,
  "name": "Arjun Mehta",
  "time": "06:45",
  "timezone": "Asia/Kolkata"
}

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Changes

No recorded changes to this operation across all 2 revisions of this API.