FlightLabs · Schema

FlightData

Schema for a real-time or historical flight data record from the FlightLabs API

AviationFlightsAirlinesAirportsFlight TrackingTravelReal-Time Data

Properties

Name Type Description
hex string ICAO24 hex identifier for the aircraft
reg_number string Aircraft registration number
flag string Country flag code (ISO 2-letter)
lat number Aircraft latitude in decimal degrees
lng number Aircraft longitude in decimal degrees
alt number Aircraft altitude in feet
dir number Aircraft heading in degrees (0-360)
speed number Aircraft speed in km/h
v_speed number Vertical speed in ft/min
squawk string Transponder squawk code
flight_number string Flight number (numeric portion)
flight_icao string Flight ICAO code (3-letter airline ICAO + flight number)
flight_iata string Flight IATA code (2-letter airline IATA + flight number)
dep_icao string Departure airport ICAO code
dep_iata string Departure airport IATA code
arr_icao string Arrival airport ICAO code
arr_iata string Arrival airport IATA code
airline_icao string Operating airline ICAO code
airline_iata string Operating airline IATA code
eta integer Estimated time of arrival as Unix timestamp
status string Current flight status
updated integer Last update time as Unix timestamp
View JSON Schema on GitHub

JSON Schema

flight.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/flightlabs/refs/heads/main/json-schema/flight.json",
  "title": "FlightData",
  "description": "Schema for a real-time or historical flight data record from the FlightLabs API",
  "type": "object",
  "properties": {
    "hex": {
      "type": "string",
      "description": "ICAO24 hex identifier for the aircraft",
      "example": "a1b2c3"
    },
    "reg_number": {
      "type": "string",
      "description": "Aircraft registration number",
      "example": "N12345"
    },
    "flag": {
      "type": "string",
      "description": "Country flag code (ISO 2-letter)",
      "example": "US"
    },
    "lat": {
      "type": "number",
      "description": "Aircraft latitude in decimal degrees",
      "minimum": -90,
      "maximum": 90,
      "example": 40.7128
    },
    "lng": {
      "type": "number",
      "description": "Aircraft longitude in decimal degrees",
      "minimum": -180,
      "maximum": 180,
      "example": -74.006
    },
    "alt": {
      "type": "number",
      "description": "Aircraft altitude in feet",
      "example": 35000
    },
    "dir": {
      "type": "number",
      "description": "Aircraft heading in degrees (0-360)",
      "minimum": 0,
      "maximum": 360,
      "example": 270.5
    },
    "speed": {
      "type": "number",
      "description": "Aircraft speed in km/h",
      "example": 900
    },
    "v_speed": {
      "type": "number",
      "description": "Vertical speed in ft/min",
      "example": 0
    },
    "squawk": {
      "type": "string",
      "description": "Transponder squawk code",
      "pattern": "^[0-7]{4}$",
      "example": "1234"
    },
    "flight_number": {
      "type": "string",
      "description": "Flight number (numeric portion)",
      "example": "100"
    },
    "flight_icao": {
      "type": "string",
      "description": "Flight ICAO code (3-letter airline ICAO + flight number)",
      "example": "AAL100"
    },
    "flight_iata": {
      "type": "string",
      "description": "Flight IATA code (2-letter airline IATA + flight number)",
      "example": "AA100"
    },
    "dep_icao": {
      "type": "string",
      "description": "Departure airport ICAO code",
      "example": "KJFK"
    },
    "dep_iata": {
      "type": "string",
      "description": "Departure airport IATA code",
      "example": "JFK"
    },
    "arr_icao": {
      "type": "string",
      "description": "Arrival airport ICAO code",
      "example": "KLAX"
    },
    "arr_iata": {
      "type": "string",
      "description": "Arrival airport IATA code",
      "example": "LAX"
    },
    "airline_icao": {
      "type": "string",
      "description": "Operating airline ICAO code",
      "example": "AAL"
    },
    "airline_iata": {
      "type": "string",
      "description": "Operating airline IATA code",
      "example": "AA"
    },
    "eta": {
      "type": "integer",
      "description": "Estimated time of arrival as Unix timestamp",
      "example": 1720000000
    },
    "status": {
      "type": "string",
      "description": "Current flight status",
      "enum": ["en-route", "landed", "scheduled", "cancelled", "diverted"],
      "example": "en-route"
    },
    "updated": {
      "type": "integer",
      "description": "Last update time as Unix timestamp",
      "example": 1719999000
    }
  },
  "additionalProperties": true
}