OpenSky Network · Schema

TrackResponse

A track response from the OpenSky Network REST API representing the trajectory of an aircraft as a sequence of waypoints.

AviationFlight TrackingADS-BAircraftAirportReal-TimeHistorical Data

Properties

Name Type Description
icao24 string Unique ICAO 24-bit address of the transponder in lower-case hex string representation.
startTime integer Time of the first waypoint in Unix time (seconds since epoch).
endTime integer Time of the last waypoint in Unix time (seconds since epoch).
callsign stringnull Callsign of the aircraft. Can be null.
path array Array of waypoints ordered by time. Each waypoint is an array with 6 indexed fields.
View JSON Schema on GitHub

JSON Schema

track-response.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/opensky/refs/heads/main/json-schema/track-response.json",
  "title": "TrackResponse",
  "description": "A track response from the OpenSky Network REST API representing the trajectory of an aircraft as a sequence of waypoints.",
  "type": "object",
  "required": ["icao24", "startTime", "endTime", "path"],
  "properties": {
    "icao24": {
      "type": "string",
      "description": "Unique ICAO 24-bit address of the transponder in lower-case hex string representation.",
      "pattern": "^[0-9a-f]{6}$",
      "example": "3c6444"
    },
    "startTime": {
      "type": "integer",
      "description": "Time of the first waypoint in Unix time (seconds since epoch).",
      "example": 1517220000
    },
    "endTime": {
      "type": "integer",
      "description": "Time of the last waypoint in Unix time (seconds since epoch).",
      "example": 1517223600
    },
    "callsign": {
      "type": ["string", "null"],
      "description": "Callsign of the aircraft. Can be null.",
      "example": "DLH400 "
    },
    "path": {
      "type": "array",
      "description": "Array of waypoints ordered by time. Each waypoint is an array with 6 indexed fields.",
      "items": {
        "$ref": "#/$defs/Waypoint"
      }
    }
  },
  "$defs": {
    "Waypoint": {
      "type": "array",
      "title": "Waypoint",
      "description": "A single waypoint in an aircraft track with 6 indexed fields: [time, latitude, longitude, baro_altitude, true_track, on_ground].",
      "minItems": 6,
      "maxItems": 6,
      "prefixItems": [
        {
          "type": "integer",
          "title": "time",
          "description": "Unix timestamp of this waypoint.",
          "example": 1517220060
        },
        {
          "type": ["number", "null"],
          "title": "latitude",
          "description": "WGS-84 latitude in decimal degrees.",
          "minimum": -90,
          "maximum": 90,
          "example": 50.0379
        },
        {
          "type": ["number", "null"],
          "title": "longitude",
          "description": "WGS-84 longitude in decimal degrees.",
          "minimum": -180,
          "maximum": 180,
          "example": 8.5622
        },
        {
          "type": ["number", "null"],
          "title": "baro_altitude",
          "description": "Barometric altitude in meters.",
          "example": 609.6
        },
        {
          "type": ["number", "null"],
          "title": "true_track",
          "description": "True track in decimal degrees clockwise from north.",
          "minimum": 0,
          "maximum": 360,
          "example": 285.3
        },
        {
          "type": "boolean",
          "title": "on_ground",
          "description": "Boolean indicating if the aircraft is on the ground at this waypoint.",
          "example": false
        }
      ]
    }
  }
}