Search connections

POST

/flights/connections/search/v1

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.

Allowed values:

Response

Successful Response

connectionslist of objects

Errors

422

Flights Search Connections V1request Unprocessable Entity Error

1	import { ChrtClient } from "@chrt-inc/typescript-sdk";
2
3	async function main() {
4	const client = new ChrtClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.flights.searchConnectionsV1({
8	destination: "LAX",
9	local_date_time: "2024-01-15T09:30:00",
10	origin: "EWR",
11	search_by: "departure_time",
12	});
13	}
14	main();

1	{
2	"connections": [
3	{
4	"legs": [
5	{}
6	],
7	"stops": 1,
8	"elapsed_minutes": 180,
9	"score": 85
10	}
11	]
12	}