CHchrt
/flights

Search connections

Searches Cirium for cargo flight connections between two airports, anchored on a departure or arrival time, ordered by earliest final arrival with unknown arrivals last. | (FlightConnectionsSearchReq) -> (FlightConnectionsSearchRes)

post/flights/connections/search/v1

Request

  • Base URL
    http://localhost:8000
  • URL
    http://localhost:8000/flights/connections/search/v1
  • Auth
    HTTP bearer

Request body

originstring required

Departure airport code (IATA preferred), e.g. 'EWR'.

destinationstring required

Arrival airport code (IATA preferred), e.g. 'LAX'.

search_by'departure_time' | 'arrival_time' required
prefer'earliest' | 'latest'
local_date_timestring date-time required

Airport-local date+time (naive, no offset). Origin-local for DEPARTURE_TIME, destination-local for ARRIVAL_TIME.

num_hoursinteger

Search window size in hours relative to local_date_time. Default 6; Cirium max 24.

max_connectionsinteger

Max stops per itinerary. 0 returns nonstop only.

max_resultsinteger

Max number of connections to return.

allow_nearby_departuresboolean

Include airports sharing the origin's city code.

allow_nearby_arrivalsboolean

Include airports sharing the destination's city code.

minimum_connect_time_minutesinteger nullable

Minimum layover in minutes; useful for cargo since published connect times are not auto-applied for cargo payloads.

include_airlinesstring[] nullable

Restrict to these airline codes.

exclude_airlinesstring[] nullable

Exclude these airline codes.

include_airportsstring[] nullable

Restrict connections to pass through these airports.

exclude_airportsstring[] nullable

Exclude these airports from connections.

Response

Successful Response

Changes

No recorded changes to this operation across all 20 revisions of this API.