Skip to main content
POST/v1/western/transits/daily

Western Daily Transits

Current sky positions vs natal chart. Returns all 10 planets with tropical longitudes and active aspects to natal positions using standard modern Western transit orbs: major 3°, sextile 2°, minor 1°. Defaults to today if no date given.

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
start_dateoptional
string | null
Transit reference date (YYYY-MM-DD): snapshot day for daily transits; window start for weekly (7 days) and monthly (30 days). Defaults to today.

Response fields

success
boolean
True if the request succeeded
message
string
Human-readable status message
data
object
data.date
string
data.transit_planets
array[object]
data.transit_planets[].name
string
data.transit_planets[].longitude
number
data.transit_planets[].sign
string
data.transit_planets[].sign_index
integer
data.transit_planets[].degree_in_sign
number
data.transit_planets[].is_retrograde
boolean
data.transit_planets[].aspects_to_natal
array[object]
data.transit_planets[].aspects_to_natal[].transit_planet
string
data.transit_planets[].aspects_to_natal[].natal_planet
string
data.transit_planets[].aspects_to_natal[].type
string
data.transit_planets[].aspects_to_natal[].exact_angle
number
data.transit_planets[].aspects_to_natal[].orb
number
data.transit_planets[].aspects_to_natal[].is_applying
boolean
data.aspects
array[object]
data.aspects[].transit_planet
string
data.aspects[].natal_planet
string
data.aspects[].type
string
data.aspects[].exact_angle
number
data.aspects[].orb
number
data.aspects[].is_applying
boolean
data.total_aspects
integer

Errors

Missing or invalid API key.
Upstream ephemeris service error.
API key tier does not include this endpoint.
Unexpected server error.
Too many requests in a short window.
Request body exceeds the size limit.
Referenced resource was not found.
Request body failed schema validation.