---
title: "Search connections"
method: POST
path: "/flights/connections/search/v1"
tags: ["/flights"]
---

# 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)

## Request body

- FlightConnectionsSearchReq
  - `origin` string, required — Departure airport code (IATA preferred), e.g. 'EWR'.
  - `destination` string, required — Arrival airport code (IATA preferred), e.g. 'LAX'.
  - `search_by` 'departure_time' | 'arrival_time', required
  - `prefer` 'earliest' | 'latest'
  - `local_date_time` string, date-time, required — Airport-local date+time (naive, no offset). Origin-local for DEPARTURE_TIME, destination-local for ARRIVAL_TIME.
  - `num_hours` integer — Search window size in hours relative to local_date_time. Default 6; Cirium max 24.
  - `max_connections` integer — Max stops per itinerary. 0 returns nonstop only.
  - `max_results` integer — Max number of connections to return.
  - `allow_nearby_departures` boolean — Include airports sharing the origin's city code.
  - `allow_nearby_arrivals` boolean — Include airports sharing the destination's city code.
  - `minimum_connect_time_minutes` integer, nullable — Minimum layover in minutes; useful for cargo since published connect times are not auto-applied for cargo payloads.
  - `include_airlines` string[], nullable — Restrict to these airline codes.
  - `exclude_airlines` string[], nullable — Exclude these airline codes.
  - `include_airports` string[], nullable — Restrict connections to pass through these airports.
  - `exclude_airports` string[], nullable — Exclude these airports from connections.

## Response `200`

Successful Response

- FlightConnectionsSearchRes
  - `connections` FlightConnection[]
    - `elapsed_minutes` integer, nullable
    - `score` integer, nullable
    - `stops` integer, required
    - `legs` FlightConnectionLeg[], required
      - `carrier_iata` string, nullable
      - `carrier_name` string, nullable
      - `flight_number` string, nullable
      - `origin_iata` string, nullable
      - `origin_name` string, nullable
      - `origin_time_zone` string, nullable
      - `origin_latitude` number, nullable
      - `origin_longitude` number, nullable
      - `destination_iata` string, nullable
      - `destination_name` string, nullable
      - `destination_time_zone` string, nullable
      - `destination_latitude` number, nullable
      - `destination_longitude` number, nullable
      - `departure_time_utc` string, date-time, nullable
      - `arrival_time_utc` string, date-time, nullable
      - `equipment_name` string, nullable
      - `is_codeshare` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)