Skip to main content
GET
Returns the latest status of one flight as of a given time: a one-sentence summary of the most recent substantive ATC communication with the flight, such as a clearance, an instruction, or a pilot report. Readbacks, check-ins, and sign-offs do not change the status. The status is built from the flight’s transmissions on available channels in the hour before at.

​
Query parameters

​
string
required
ICAO callsign, e.g. UAL406. Case-insensitive.
​
string
required
The time to report the status as of, RFC 3339. Must not be in the future. Selects transmissions by received_at as the API returns it.

​
Response

​
string
The requested callsign, normalized to upper case.
​
string
The requested time, in UTC.
​
string | null
One-sentence status. null when the flight had no substantive communication on available channels in the hour before at, including when the callsign is unknown.
​
string | null
received_at of the transmission the status was determined from, accurate to within 20 seconds.
​
integer | null
The channel the flight was communicating on.
​
string[]
Facilities that own atc_channel_id.
Statuses are written by a language model from transcripts and can contain mistakes. Check important details against the transcripts from GET /api/v0/transcripts?callsign=....

​
Billing

The status is charged as one flight_status_update, at $0.12, each time you request it. A response whose status is null is free: X-Charged-Usd is 0.000 and X-Balance-Usd is omitted. See Pricing and Billing.

​
Errors