POST · TRANSIT WESTERN

Combust

Endpoint POST https://starsapi.com/api/v3/transit/western/combust

Returns combustion windows — periods when a planet is too close to the Sun. Tropical sign positions at start/end and closest approach date with minimum angular distance.

Authentication

Required.

Request body

FieldTypeRequiredDescription
query_typestringNocurrent (default), date, range, month, year.
timezonestringNoIANA timezone. Default UTC.
planetstringNoPlanet filter or all. Sun is never combust.
datestring*Required for date.
from_date, to_datestring*Required for range.
month, yearinteger*Required for month/year.
include_moonbooleanNoInclude Moon combustion. Auto-managed by default.

Response shape

FieldTypeDescription
planetstringPlanet name.
start_date, start_timestringCombustion begins.
end_date, end_timestringCombustion ends.
duration_daysnumberTotal days combust.
sign_at_startstringTropical sign when combustion begins.
sign_at_endstringTropical sign when combustion ends.
closest_datestringDate of minimum Sun distance.
closest_distance_degnumberMinimum angular distance (degrees).

See also