---
title: "Flight legs"
method: GET
path: "/tracking/sessions/flight_legs/v1"
tags: ["/tracking", "/tracking/sessions/flights"]
---

# Flight legs

`GET /tracking/sessions/flight_legs/v1`

Returns the session's flight legs in order, with Cirium-sourced status lazily resolved and refreshed on read. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (list[FlightLeg1])

## Query parameters

- `session_id` string, required

## Response `200`

Successful Response

- FlightLeg1[]
  - `schema_version` 1, required
  - `_id` string, required
  - `order_id` string, nullable
  - `task_group_id` string, nullable
  - `session_id` string, nullable
  - `flight_number` string, required
  - `provenance` 'manual' | 'cirium' | 'flightaware', required
  - `origin_iata` string, required
  - `destination_iata` string, required
  - `scheduled_departure_utc` string, date-time, required
  - `carrier_iata` string, required
  - `carrier_icao` string, nullable
  - `scheduled_arrival_utc` string, date-time, nullable
  - `cirium_flight_id` integer, nullable
  - `flight_status` 'scheduled' | 'departed_gate' | 'in_flight' | 'landed' | 'arrived_gate' | 'cancelled' | 'diverted' | 'unknown'
  - `estimated_departure_utc` string, date-time, nullable
  - `actual_departure_utc` string, date-time, nullable
  - `estimated_arrival_utc` string, date-time, nullable
  - `actual_arrival_utc` string, date-time, nullable
  - `departure_gate` string, nullable
  - `arrival_gate` string, nullable
  - `departure_terminal` string, nullable
  - `arrival_terminal` string, nullable
  - `flight_status_source` 'live' | 'historical'
  - `flight_status_fetched_at_utc` string, date-time, 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)