POST/v1/western/events

Western 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. Exact major aspects from the transiting planets to the natal planets and angles, tropical sign ingresses and stations (Sun to Saturn), Moon sign changes, void-of-course periods, New and Full Moons and quarters, eclipses with their contacts, and the profection year turning on the birthday. Each event carries the verdict Lilly's rules give, or null; Uranus, Neptune and Pluto carry none. 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, the chart is cast for 06:00 local time (not a sunrise chart) and birth_time_provided is false: houses, the Ascendant, the sect and the Moon's exact degree are then approximate.

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

Ignored on Western endpoints: positions are always tropical (no ayanamsa). Accepted so one birth object can be sent to Vedic and Western endpoints alike.

house_systemoptional

string

Natal house system for the Ascendant and MC.

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

• Western Daily Transits
• Western Monthly Transits
• Western Weekly Transits
• Western daily factors

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/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.western_astrology_api import WesternAstrologyApi
from asterwise.models.western_events_request import WesternEventsRequest

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

request = WesternEventsRequest(
    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 = WesternAstrologyApi(client)
    result = api.western_events(western_events_request=request)
    print(result)

TypeScript

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

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

const result = await westernEvents({
  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": {
      "sun_sign": "Scorpio",
      "moon_sign": "Scorpio",
      "ascendant_sign": "Scorpio"
    },
    "events": [
      {
        "kind": "aspect_exact",
        "planet": "Moon",
        "title": "Moon trine natal Jupiter (exact)",
        "time_utc": "2026-01-01T04:38:24Z",
        "time_local": "2026-01-01T10:08:24+05:30",
        "time_precision": "second",
        "detail": {
          "natal_point": "Jupiter",
          "aspect": "trine",
          "angle": 120.0
        },
        "verdict": "favorable",
        "verdict_rule": "Trine: an aspect of love and friendship",
        "rule_source": "Lilly, Christian Astrology (1647), Book 2 (aspects); fortunes and infortunes pp. 57, 61, 65, 72",
        "significations": [
          "lilly.planet.moon",
          "lilly.planet.jupiter"
        ],
        "depends_on_birth_time": false
      },
      {
        "kind": "aspect_exact",
        "planet": "Moon",
        "title": "Moon trine natal Mars (exact)",
        "time_utc": "2026-01-01T04:41:54Z",
        "time_local": "2026-01-01T10:11:54+05:30",
        "time_precision": "second",
        "detail": {
          "natal_point": "Mars",
          "aspect": "trine",
          "angle": 120.0
        },
        "verdict": "favorable",
        "verdict_rule": "Trine: an aspect of love and friendship",
        "rule_source": "Lilly, Christian Astrology (1647), Book 2 (aspects); fortunes and infortunes pp. 57, 61, 65, 72",
        "significations": [
          "lilly.planet.moon",
          "lilly.planet.mars"
        ],
        "depends_on_birth_time": false
      },
      "... and 42 more items"
    ],
    "kinds": {
      "aspect_exact": "a transiting planet makes an exact major aspect to a natal planet or angle",
      "ingress": "a planet enters a tropical sign",
      "moon_sign": "the Moon enters a sign",
      "station": "a planet turns retrograde or direct",
      "void_of_course": "the Moon's last aspect in its sign (void until the next sign)",
      "moon_phase": "New Moon, First Quarter, Full Moon, Last Quarter",
      "eclipse": "a solar or lunar eclipse, with contacts to the chart",
      "profection_year": "the profection year turns on the birthday"
    },
    "note": "Events in time order with the verdict each one's own rule gives, or null. Uranus, Neptune and Pluto carry no verdict. No…"
  }
}