AeroDataBox · Schema

FlightDelayContract

Delay statistics for a flight movement

AviationFlightsAerospaceFlight DataAirport Data

Properties

Name	Type	Description
airportIcao	string	ICAO code of the airport at which statistics is observed
class	object
scheduledHourUtc	integer	Hour on which flight is scheduled (represented in UTC). If provided, it separates the statistics for the same flight departing/arriving at different time of day on different days within the observed p
medianDelay	string	Median historic delay of the flight (format: [-]hh:mm:ss). Value can be negative (therefore, means early occurence).
delayPercentiles	array	Distribution of historic delays of the flight in percentiles from 5 percentile to 95 percentile in steps of 5 percentile, allowing for a more detailed analysis of delay patterns beyond simple averages
numConsideredFlights	integer	The number of flight movements taken into account to calculate this statistics.
numFlightsDelayedBrackets	array	Brackets containing information more detailed information about how many flights were delayed/early per specific delay range brackets (e.g. late from 15 to 30 minutes, from 30 to 60, etc.)
fromUtc	string	The beginning of the time range within which flght delay information is calculated (represented in UTC time)
toUtc	string	The end of the time range within which flght delay information is calculated (represented in UTC time)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/FlightDelayContract",
  "title": "FlightDelayContract",
  "required": [
    "airportIcao",
    "class",
    "delayPercentiles",
    "fromUtc",
    "medianDelay",
    "numConsideredFlights",
    "numFlightsDelayedBrackets",
    "toUtc"
  ],
  "type": "object",
  "properties": {
    "airportIcao": {
      "minLength": 1,
      "type": "string",
      "description": "ICAO code of the airport at which statistics is observed"
    },
    "class": {
      "$ref": "#/components/schemas/StatisticClass"
    },
    "scheduledHourUtc": {
      "type": "integer",
      "description": "Hour on which flight is scheduled (represented in UTC).\r\n\r\nIf provided, it separates the statistics for the same flight departing/arriving at different time of day\r\non different days within the observed period.",
      "format": "int32",
      "nullable": true
    },
    "medianDelay": {
      "type": "string",
      "description": "Median historic delay of the flight (format: [-]hh:mm:ss).\r\nValue can be negative (therefore, means early occurence).",
      "format": "date-span"
    },
    "delayPercentiles": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PercentileBracketContract"
      },
      "description": "Distribution of historic delays of the flight in percentiles from 5 percentile to 95 percentile in steps of 5 percentile, \r\nallowing for a more detailed analysis of delay patterns beyond simple averages or medians."
    },
    "numConsideredFlights": {
      "type": "integer",
      "description": "The number of flight movements taken into account to calculate this\r\nstatistics.",
      "format": "int32"
    },
    "numFlightsDelayedBrackets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/DelayBracketContract"
      },
      "description": "Brackets containing information more detailed information about\r\nhow many flights were delayed/early per specific delay range brackets\r\n(e.g. late from 15 to 30 minutes, from 30 to 60, etc.)"
    },
    "fromUtc": {
      "type": "string",
      "description": "The beginning of the time range within which flght delay information is calculated (represented in UTC time)",
      "format": "date-time"
    },
    "toUtc": {
      "type": "string",
      "description": "The end of the time range within which flght delay information is calculated (represented in UTC time)",
      "format": "date-time"
    }
  },
  "additionalProperties": false,
  "description": "Delay statistics for a flight movement"
}