OpenSky Network · Schema

FlightObject

A flight record returned by the OpenSky Network flight endpoints representing a single detected flight with estimated departure and arrival airports.

AviationFlight TrackingADS-BAircraftAirportReal-TimeHistorical Data

Properties

Name Type Description
icao24 string Unique ICAO 24-bit address of the transponder in hex string representation. All letters are lower case.
firstSeen integer Estimated time of departure for the flight as Unix time (seconds since epoch).
estDepartureAirport stringnull ICAO code of the estimated departure airport. Can be null if the airport could not be identified.
lastSeen integer Estimated time of arrival for the flight as Unix time (seconds since epoch).
estArrivalAirport stringnull ICAO code of the estimated arrival airport. Can be null if the airport could not be identified.
callsign stringnull Callsign of the vehicle (8 chars). Can be null if no callsign has been received. If the vehicle transmits multiple callsigns during the flight, the most frequently seen one is used.
estDepartureAirportHorizDistance integernull Horizontal distance of the last received airborne position to the estimated departure airport in meters.
estDepartureAirportVertDistance integernull Vertical distance of the last received airborne position to the estimated departure airport in meters.
estArrivalAirportHorizDistance integernull Horizontal distance of the last received airborne position to the estimated arrival airport in meters.
estArrivalAirportVertDistance integernull Vertical distance of the last received airborne position to the estimated arrival airport in meters.
departureAirportCandidatesCount integer Number of other possible departure airports in short distance to estDepartureAirport.
arrivalAirportCandidatesCount integer Number of other possible arrival airports in short distance to estArrivalAirport.
View JSON Schema on GitHub

JSON Schema

flight-object.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/opensky/refs/heads/main/json-schema/flight-object.json",
  "title": "FlightObject",
  "description": "A flight record returned by the OpenSky Network flight endpoints representing a single detected flight with estimated departure and arrival airports.",
  "type": "object",
  "required": ["icao24", "firstSeen", "lastSeen"],
  "properties": {
    "icao24": {
      "type": "string",
      "description": "Unique ICAO 24-bit address of the transponder in hex string representation. All letters are lower case.",
      "pattern": "^[0-9a-f]{6}$",
      "example": "3c6444"
    },
    "firstSeen": {
      "type": "integer",
      "description": "Estimated time of departure for the flight as Unix time (seconds since epoch).",
      "example": 1517220000
    },
    "estDepartureAirport": {
      "type": ["string", "null"],
      "description": "ICAO code of the estimated departure airport. Can be null if the airport could not be identified.",
      "example": "EDDF"
    },
    "lastSeen": {
      "type": "integer",
      "description": "Estimated time of arrival for the flight as Unix time (seconds since epoch).",
      "example": 1517223600
    },
    "estArrivalAirport": {
      "type": ["string", "null"],
      "description": "ICAO code of the estimated arrival airport. Can be null if the airport could not be identified.",
      "example": "EGLL"
    },
    "callsign": {
      "type": ["string", "null"],
      "description": "Callsign of the vehicle (8 chars). Can be null if no callsign has been received. If the vehicle transmits multiple callsigns during the flight, the most frequently seen one is used.",
      "maxLength": 8,
      "example": "DLH400 "
    },
    "estDepartureAirportHorizDistance": {
      "type": ["integer", "null"],
      "description": "Horizontal distance of the last received airborne position to the estimated departure airport in meters.",
      "minimum": 0,
      "example": 1250
    },
    "estDepartureAirportVertDistance": {
      "type": ["integer", "null"],
      "description": "Vertical distance of the last received airborne position to the estimated departure airport in meters.",
      "minimum": 0,
      "example": 304
    },
    "estArrivalAirportHorizDistance": {
      "type": ["integer", "null"],
      "description": "Horizontal distance of the last received airborne position to the estimated arrival airport in meters.",
      "minimum": 0,
      "example": 1800
    },
    "estArrivalAirportVertDistance": {
      "type": ["integer", "null"],
      "description": "Vertical distance of the last received airborne position to the estimated arrival airport in meters.",
      "minimum": 0,
      "example": 152
    },
    "departureAirportCandidatesCount": {
      "type": "integer",
      "description": "Number of other possible departure airports in short distance to estDepartureAirport.",
      "minimum": 0,
      "example": 0
    },
    "arrivalAirportCandidatesCount": {
      "type": "integer",
      "description": "Number of other possible arrival airports in short distance to estArrivalAirport.",
      "minimum": 0,
      "example": 1
    }
  }
}