POST/v1/astro/events

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.

Request parameters

from_dateoptional

string | null

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

daysoptional

integer

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

target_timezoneoptional

string | null

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

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 (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_offsetoptional

string | null

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.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

target_latitudeoptional

number | null

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

target_longitudeoptional

number | null

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

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.birth_time_provided

boolean

data.start_date

string

data.end_date

string

data.days

integer

data.timezone

string

data.range_start_utc

string

data.range_end_utc

string

data.natal

object

data.events

array[object]

All events in time order.

data.events[].kind

string

Event kind; see kinds in the response.

data.events[].planet

string | null

data.events[].title

string

data.events[].time_utc

string

ISO 8601 UTC with Z.

data.events[].time_local

string

ISO 8601 local time with offset, in target_timezone.

data.events[].time_precision

string

second, or day for events known only to the day (dasha changes, profection years).

data.events[].detail

object

data.events[].verdict

string | null

data.events[].verdict_rule

string | null

data.events[].rule_source

string | null

data.events[].significations

array[string]

data.events[].depends_on_birth_time

boolean

data.kinds

object

data.note

string

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Gochar — Transit Analysis
• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Tarabala and Chandrabala
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points
• Vedic daily factors

Request

POST·application/json

curl

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

Python

import asterwise
from asterwise.api.advanced_api import AdvancedApi
from asterwise.models.vedic_events_request import VedicEventsRequest

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

request = VedicEventsRequest(
    name="Arjun Mehta",
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
    from_date="2026-01-01",
    days=7,
)

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

TypeScript

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

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

const result = await vedicEvents({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata",
      "from_date": "2026-01-01",
      "days": 7
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "start_date": "2026-01-01",
    "end_date": "2026-01-07",
    "days": 7,
    "timezone": "Asia/Kolkata",
    "range_start_utc": "2025-12-31T18:30:00Z",
    "range_end_utc": "2026-01-07T18:30:00Z",
    "birth_time_provided": true,
    "natal": {
      "moon_sign": "Tula",
      "moon_nakshatra_index": 14,
      "ascendant_sign": "Tula"
    },
    "events": [
      {
        "kind": "moon_nakshatra",
        "planet": "Moon",
        "title": "Moon enters Rohini (Mitra tara)",
        "time_utc": "2025-12-31T20:00:11Z",
        "time_local": "2026-01-01T01:30:11+05:30",
        "time_precision": "second",
        "detail": {
          "nakshatra": "Rohini",
          "nakshatra_index": 3,
          "ends_utc": "2026-01-01T17:18:35Z",
          "tarabala": {
            "count_from_birth": 17,
            "tara_number": 8,
            "cycle": 2,
            "cycle_name": "Anujanma",
            "name": "Mitra",
            "meaning": "Friend",
            "is_favorable": true,
            "is_moon_in_birth_nakshatra": false
          }
        },
        "verdict": "favorable",
        "verdict_rule": "Tara 8 (Mitra) from the birth nakshatra",
        "rule_source": "Muhurta Chintamani (Tarabala)",
        "significations": [
          "bphs.planet.moon"
        ],
        "depends_on_birth_time": true
      },
      {
        "kind": "moon_nakshatra",
        "planet": "Moon",
        "title": "Moon enters Mrigashira (Ati-Mitra tara)",
        "time_utc": "2026-01-01T17:18:35Z",
        "time_local": "2026-01-01T22:48:35+05:30",
        "time_precision": "second",
        "detail": {
          "nakshatra": "Mrigashira",
          "nakshatra_index": 4,
          "ends_utc": "2026-01-02T14:34:09Z",
          "tarabala": {
            "count_from_birth": 18,
            "tara_number": 9,
            "cycle": 2,
            "cycle_name": "Anujanma",
            "name": "Ati-Mitra",
            "meaning": "Great Friend",
            "is_favorable": true,
            "is_moon_in_birth_nakshatra": false
          }
        },
        "verdict": "favorable",
        "verdict_rule": "Tara 9 (Ati-Mitra) from the birth nakshatra",
        "rule_source": "Muhurta Chintamani (Tarabala)",
        "significations": [
          "bphs.planet.moon"
        ],
        "depends_on_birth_time": true
      },
      "... and 12 more items"
    ],
    "kinds": {
      "ingress": "a planet enters a sidereal sign",
      "station": "a planet turns retrograde or direct",
      "moon_nakshatra": "the Moon enters a nakshatra (with Tarabala)",
      "moon_sign": "the Moon enters a sign (with Chandrabala)",
      "natal_conjunction": "a transiting planet reaches the exact degree of a natal planet",
      "eclipse": "a solar or lunar eclipse, with contacts to the chart",
      "dasha_change": "a Vimshottari period changes (to the day)"
    },
    "note": "Events in time order with the verdict each one's own rule gives, or null. No weighting."
  }
}