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

# Flight track

`GET /tracking/sessions/flight_track/v1`

Returns the Cirium positional track for one of the session's flight legs; pass force_refresh=true to bypass the cache. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (FlightTrackRes)

## Query parameters

- `session_id` string, required
- `flight_leg_id` string, required
- `force_refresh` boolean — Bypass the cache and fetch the latest flight track.

## Response `200`

Successful Response

- FlightTrackRes — Positional track for a flight leg: live trail + (optional) planned path. `positions` is the flown breadcrumb trail (present once airborne); `waypoints` / `legacy_route` are the planned path (present once Cirium has the filed flight plan, ~24h before departure). Everything is empty when the leg has no resolvable Cirium `flightId` or Cirium has no track yet — the endpoint never errors on a missing track (fail-soft, like the status route).
  - `cirium_flight_id` integer, nullable
  - `positions` FlightTrackPosition1[]
    - `lat` number, nullable
    - `lon` number, nullable
    - `altitude_ft` integer, nullable
    - `speed_mph` integer, nullable
    - `source` string, nullable
    - `date_utc` string, date-time, nullable
  - `waypoints` FlightTrackWaypoint1[]
    - `lat` number, nullable
    - `lon` number, nullable
  - `legacy_route` string, nullable
  - `bearing` number, nullable
  - `heading` number, 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)