Skip to main content
GET
/
api
/
aviation
/
v1
/
get-flight-status
GetFlightStatus
curl --request GET \
  --url https://api.example.com/api/aviation/v1/get-flight-status
{
  "flights": [
    {
      "flightNumber": "<string>",
      "date": "<string>",
      "operatingCarrier": {
        "iataCode": "<string>",
        "icaoCode": "<string>",
        "name": "<string>"
      },
      "origin": {
        "iata": "<string>",
        "icao": "<string>",
        "name": "<string>",
        "timezone": "<string>"
      },
      "destination": {
        "iata": "<string>",
        "icao": "<string>",
        "name": "<string>",
        "timezone": "<string>"
      },
      "scheduledDeparture": 123,
      "estimatedDeparture": 123,
      "actualDeparture": 123,
      "scheduledArrival": 123,
      "estimatedArrival": 123,
      "actualArrival": 123,
      "status": "FLIGHT_INSTANCE_STATUS_UNSPECIFIED",
      "delayMinutes": 123,
      "cancelled": true,
      "diverted": true,
      "gate": "<string>",
      "terminal": "<string>",
      "aircraftIcao24": "<string>",
      "aircraftType": "<string>",
      "codeshareFlightNumbers": [
        "<string>"
      ],
      "source": "<string>",
      "updatedAt": 123
    }
  ],
  "source": "<string>",
  "cacheHit": true
}

Query Parameters

flight_number
string

IATA flight number (e.g., "TK1952").

date
string

Departure date in ISO 8601 format (e.g., "2026-03-05").

origin
string

Optional origin airport IATA code to disambiguate.

Response

Successful response

GetFlightStatusResponse contains flight status results.

flights
object[]
source
string

Data source identifier.

cacheHit
boolean

Whether the response was served from cache.