AeroDataBox Statistical API API
The Statistical API API from AeroDataBox — 8 operation(s) for statistical api.
The Statistical API API from AeroDataBox — 8 operation(s) for statistical api.
openapi: 3.0.4
info:
title: AeroDataBox API - Aviation and Flight Aircraft API Statistical API API
description: Affordable aviation & flight data API tailored for small and medium businesses, teams and individual developers.
termsOfService: https://aerodatabox.com/terms/
contact:
url: https://aerodatabox.com/contact/
version: 1.14.0.0
servers:
- url: https://prod.api.market/api/v1/aedbx/aerodatabox
security: {}
tags:
- name: Statistical API
paths:
/airports/{codeType}/{code}/delays:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Airport Delays (current or Historical Moment) / TIER 3
description: "**What is the current or historical average delay in the airport?** or **What is the delay index of the airport right now or at a moment in past?**\r\n\r\nPlease read more about airport delays on here: https://aerodatabox.com/api-airport-delays/\r\n\r\n*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by:\r\n* a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the current moment, if no `dateLocal` is specified;\r\n* a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the moment requested in `dateLocal`, if `dateLocal` is specified;"
operationId: GetAirportDelay_DelaysCurrent
parameters:
- name: codeType
in: path
description: Type of code to search airport by (`iata` or `icao`)
schema:
$ref: '#/components/schemas/AirportCodesByEnum'
- name: code
in: path
description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character IATA-code of the airport (e.g.: AMS, SFO, LAX, etc.).\r\n\r\nFull, stripped and any case formats are acceptable."
required: true
schema:
maxLength: 4
minLength: 3
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AirportDelayContract'
examples:
GetAirportDelay_DelaysCurrent200Example:
summary: Default GetAirportDelay_DelaysCurrent 200 response
x-microcks-default: true
value:
airportIcao: KLAX
from: example_value
to: example_value
departuresDelayInformation: example_value
arrivalsDelayInformation: example_value
application/xml:
schema:
$ref: '#/components/schemas/AirportDelayContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysCurrent400Example:
summary: Default GetAirportDelay_DelaysCurrent 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysCurrent401Example:
summary: Default GetAirportDelay_DelaysCurrent 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysCurrent451Example:
summary: Default GetAirportDelay_DelaysCurrent 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysCurrent500Example:
summary: Default GetAirportDelay_DelaysCurrent 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/{codeType}/{code}/delays/{dateLocal}:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Airport Delays (current or Historical Moment) / TIER 3
description: "**What is the current or historical average delay in the airport?** or **What is the delay index of the airport right now or at a moment in past?**\r\n\r\nPlease read more about airport delays on here: https://aerodatabox.com/api-airport-delays/\r\n\r\n*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by:\r\n* a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the current moment, if no `dateLocal` is specified;\r\n* a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the moment requested in `dateLocal`, if `dateLocal` is specified;"
operationId: GetAirportDelay_DelaysHistorical
parameters:
- name: codeType
in: path
description: Type of code to search airport by (`iata` or `icao`)
schema:
$ref: '#/components/schemas/AirportCodesByEnum'
- name: code
in: path
description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character IATA-code of the airport (e.g.: AMS, SFO, LAX, etc.).\r\n\r\nFull, stripped and any case formats are acceptable."
required: true
schema:
maxLength: 4
minLength: 3
type: string
- name: dateLocal
in: path
description: "The moment of time for / from which delay data is requested (local time, format: YYYY-MM-DDTHH:mm). \r\nDefault - current time."
required: true
schema:
pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
type: string
format: date-time
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AirportDelayContract'
examples:
GetAirportDelay_DelaysHistorical200Example:
summary: Default GetAirportDelay_DelaysHistorical 200 response
x-microcks-default: true
value:
airportIcao: KLAX
from: example_value
to: example_value
departuresDelayInformation: example_value
arrivalsDelayInformation: example_value
application/xml:
schema:
$ref: '#/components/schemas/AirportDelayContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysHistorical400Example:
summary: Default GetAirportDelay_DelaysHistorical 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysHistorical401Example:
summary: Default GetAirportDelay_DelaysHistorical 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysHistorical451Example:
summary: Default GetAirportDelay_DelaysHistorical 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelay_DelaysHistorical500Example:
summary: Default GetAirportDelay_DelaysHistorical 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/{codeType}/{code}/delays/{dateFromLocal}/{dateToLocal}:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Airport Delays (historical Period) / TIER 3
description: "**What were the delays within a specific period of time?** or **How the delays changed within a specific period of time?**\r\n\r\nPlease read more about airport delays on here: https://aerodatabox.com/api-airport-delays/\r\n\r\n*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by a collection of `AiportDelayContract` items displaying the delay information at multiple moments within the period between `dateLocal` and `dateToLocal`."
operationId: GetAirportDelays
parameters:
- name: codeType
in: path
description: Type of code to search airport by (`iata` or `icao`)
schema:
$ref: '#/components/schemas/AirportCodesByEnum'
- name: code
in: path
description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character IATA-code of the airport (e.g.: AMS, SFO, LAX, etc.).\r\n\r\nFull, stripped and any case formats are acceptable."
required: true
schema:
maxLength: 4
minLength: 3
type: string
- name: dateFromLocal
in: path
description: 'The beginning of the period of time for which delay data is requested (local time, format: YYYY-MM-DDTHH:mm).'
required: true
schema:
pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
type: string
format: date-time
- name: dateToLocal
in: path
description: 'The end of the period of time for which delay data is requested (local time, format: YYYY-MM-DDTHH:mm).'
required: true
schema:
pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
type: string
format: date-time
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AirportDelayContract'
examples:
GetAirportDelays200Example:
summary: Default GetAirportDelays 200 response
x-microcks-default: true
value:
- example_value
application/xml:
schema:
type: array
items:
$ref: '#/components/schemas/AirportDelayContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelays400Example:
summary: Default GetAirportDelays 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelays401Example:
summary: Default GetAirportDelays 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelays451Example:
summary: Default GetAirportDelays 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetAirportDelays500Example:
summary: Default GetAirportDelays 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/{codeType}/{code}/stats/routes/daily:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Airport Routes and Daily Flight Destinations / TIER 3
description: "**What are the most popular routes from an airport?** or **Where I can fly from an airport?** or \r\n**How many daily flights to different destinations from an airport?**\r\n\r\nThe data will only be available for airports which have at least schedules information available. \r\nIf the airport is also covered with live or ADS-B coverage, the quality will improve greatly as it will\r\nbe based on real data rather than on static scheduled data. To check if an airport is tracked and on which level, \r\nuse `/health/services/airports/{icao}/feeds` endpoint. You can also use `/health/services/feeds/{service}/airports` to get \r\nthe list of covered airports. \r\n\r\nAt the moment airports having both ICAO and IATA code and flight schedules are present available only.\r\n\r\n*Returns:* List of routes and daily flights amount departing from an airport."
operationId: GetRouteDailyStatistics_RoutesDailyCurrent
parameters:
- name: codeType
in: path
description: Type of code to search airport by (`iata` or `icao`)
schema:
$ref: '#/components/schemas/AirportCodesByEnum'
- name: code
in: path
description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character IATA-code of the airport (e.g.: AMS, SFO, LAX, etc.).\r\n\r\nFull, stripped and any case formats are acceptable."
required: true
schema:
maxLength: 4
minLength: 3
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DailyRouteStatContract'
examples:
GetRouteDailyStatistics_RoutesDailyCurrent200Example:
summary: Default GetRouteDailyStatistics_RoutesDailyCurrent 200 response
x-microcks-default: true
value:
routes:
- example_value
application/xml:
schema:
$ref: '#/components/schemas/DailyRouteStatContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailyCurrent400Example:
summary: Default GetRouteDailyStatistics_RoutesDailyCurrent 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailyCurrent401Example:
summary: Default GetRouteDailyStatistics_RoutesDailyCurrent 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailyCurrent451Example:
summary: Default GetRouteDailyStatistics_RoutesDailyCurrent 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailyCurrent500Example:
summary: Default GetRouteDailyStatistics_RoutesDailyCurrent 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/{codeType}/{code}/stats/routes/daily/{dateLocal}:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Airport Routes and Daily Flight Destinations / TIER 3
description: "**What are the most popular routes from an airport?** or **Where I can fly from an airport?** or \r\n**How many daily flights to different destinations from an airport?**\r\n\r\nThe data will only be available for airports which have at least schedules information available. \r\nIf the airport is also covered with live or ADS-B coverage, the quality will improve greatly as it will\r\nbe based on real data rather than on static scheduled data. To check if an airport is tracked and on which level, \r\nuse `/health/services/airports/{icao}/feeds` endpoint. You can also use `/health/services/feeds/{service}/airports` to get \r\nthe list of covered airports. \r\n\r\nAt the moment airports having both ICAO and IATA code and flight schedules are present available only.\r\n\r\n*Returns:* List of routes and daily flights amount departing from an airport."
operationId: GetRouteDailyStatistics_RoutesDailAtSpecificDate
parameters:
- name: codeType
in: path
description: Type of code to search airport by (`iata` or `icao`)
schema:
$ref: '#/components/schemas/AirportCodesByEnum'
- name: code
in: path
description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character IATA-code of the airport (e.g.: AMS, SFO, LAX, etc.).\r\n\r\nFull, stripped and any case formats are acceptable."
required: true
schema:
maxLength: 4
minLength: 3
type: string
- name: dateLocal
in: path
description: "Local date at the airport (default = null).\r\nIf specified, returns statistics based on 7 days prior to the date specified.\r\nOtherwise, returns statistics based on 7 days prior to the current local date at the airport."
required: true
schema:
pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
type: string
format: date-time
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DailyRouteStatContract'
examples:
GetRouteDailyStatistics_RoutesDailAtSpecificDate200Example:
summary: Default GetRouteDailyStatistics_RoutesDailAtSpecificDate 200 response
x-microcks-default: true
value:
routes:
- example_value
application/xml:
schema:
$ref: '#/components/schemas/DailyRouteStatContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailAtSpecificDate400Example:
summary: Default GetRouteDailyStatistics_RoutesDailAtSpecificDate 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailAtSpecificDate401Example:
summary: Default GetRouteDailyStatistics_RoutesDailAtSpecificDate 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailAtSpecificDate451Example:
summary: Default GetRouteDailyStatistics_RoutesDailAtSpecificDate 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetRouteDailyStatistics_RoutesDailAtSpecificDate500Example:
summary: Default GetRouteDailyStatistics_RoutesDailAtSpecificDate 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/delays:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Global Delays (current or Historical Moment) / TIER 3
description: "**What is the current or historical delay situation in all airports?** or **What is the delay index of all airports globally right now or at a moment in past?**\r\n\r\nPlease read more about airport delays on here: https://aerodatabox.com/api-airport-delays/\r\n\r\n*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for all known airports, represented by a collection of items sorted by \r\nthe average of arrival and departure index, descending order (from worst to best). Only qualifying and recent enough delay statistics records are returned."
operationId: GetGlobalDelays_GlobalDelaysCurent
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AirportDelayContract'
examples:
GetGlobalDelays_GlobalDelaysCurent200Example:
summary: Default GetGlobalDelays_GlobalDelaysCurent 200 response
x-microcks-default: true
value:
airportIcao: KLAX
from: example_value
to: example_value
departuresDelayInformation: example_value
arrivalsDelayInformation: example_value
application/xml:
schema:
$ref: '#/components/schemas/AirportDelayContract'
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetGlobalDelays_GlobalDelaysCurent400Example:
summary: Default GetGlobalDelays_GlobalDelaysCurent 400 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetGlobalDelays_GlobalDelaysCurent401Example:
summary: Default GetGlobalDelays_GlobalDelaysCurent 401 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'451':
description: Unavailable For Legal Reasons
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetGlobalDelays_GlobalDelaysCurent451Example:
summary: Default GetGlobalDelays_GlobalDelaysCurent 451 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorContract'
examples:
GetGlobalDelays_GlobalDelaysCurent500Example:
summary: Default GetGlobalDelays_GlobalDelaysCurent 500 response
x-microcks-default: true
value:
message: example_value
application/xml:
schema:
$ref: '#/components/schemas/ErrorContract'
'503':
description: Service Unavailable
x-badges:
- name: TIER 3
position: before
color: '#ffb694'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/airports/delays/{dateUtc}:
parameters:
- description: API.market API Key
in: header
name: x-api-market-key
value: Please Login/Signup to get an API Key
required: true
schema:
type: string
get:
tags:
- Statistical API
summary: AeroDataBox Global Delays (current or Historical Moment) / TIER 3
description: "**What is the current or historical delay situation in all airports?** or **What is the delay index of all airports globally right now or at a moment in past?**\r\n\r\nPlease read more about airport delays on here: https://aerodatabox.com/api-airport-delays/\r\n\r\n*Returns*
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/aerodatabox/refs/heads/main/openapi/aerodatabox-statistical-api-api-openapi.yml