For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Searches Cirium for cargo flight connections between two airports, anchored on a departure or arrival time. | (FlightConnectionsSearchReq) -> (FlightConnectionsSearchRes)
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
destinationstringRequired
Arrival airport code (IATA preferred), e.g. ‘LAX’.
local_date_timedatetimeRequired
Airport-local date+time (naive, no offset). Origin-local for DEPARTURE_TIME, destination-local for ARRIVAL_TIME.
originstringRequired
Departure airport code (IATA preferred), e.g. ‘EWR’.
search_byenumRequired
Whether local_date_time is a departure constraint (leaving after) or an arrival constraint (arriving before).
Allowed values:
allow_nearby_arrivalsbooleanOptionalDefaults to false
Include airports sharing the destination's city code.
allow_nearby_departuresbooleanOptionalDefaults to false
Include airports sharing the origin's city code.
exclude_airlineslist of stringsOptional
Exclude these airline codes.
exclude_airportslist of stringsOptional
Exclude these airports from connections.
include_airlineslist of stringsOptional
Restrict to these airline codes.
include_airportslist of stringsOptional
Restrict connections to pass through these airports.
max_connectionsintegerOptional0-3Defaults to 2
Max stops per itinerary. 0 returns nonstop only.
max_resultsintegerOptional1-1000Defaults to 100
Max number of connections to return.
minimum_connect_time_minutesintegerOptional
Minimum layover in minutes; useful for cargo since published connect times are not auto-applied for cargo payloads.
num_hoursintegerOptional1-24Defaults to 6
Search window size in hours relative to local_date_time. Default 6; Cirium max 24.
preferenumOptional
Return the earliest or latest flights within the search window.
