Advanced

Vedic events over a date range

One timeline of everything that happens to a chart over 1 to 31 days, each event with its exact time. Sidereal sign ingresses with the new sign's house from the natal Moon, stations, Moon nakshatra changes with Tarabala, Moon sign changes with Chandrabala, exact degree conjunctions with natal planets, eclipses with their contacts, Purnima and Amavasya (the exact full and new Moon, with the tithi's start and end), and Vimshottari dasha changes (to the day). Each event carries the verdict its own rule gives, or null. No weighting.

post/v1/astro/events

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/events
  • Auth: HTTP bearer

Request body

from_datestring nullable

First day (YYYY-MM-DD, civil day in target_timezone). Defaults to today in the birth timezone.

daysinteger

Number of civil days, 1 to 31 (7 for a week, 30 for a month).

target_timezonestring nullable

IANA timezone that defines the days and local times. Defaults to the birth timezone.

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 nullable

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as 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_latitudenumber nullable

Place for the Moon's day boundaries. Defaults to the birthplace.

target_longitudenumber nullable

Longitude of that place, east positive. Defaults to the birthplace.

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.