openapi: 3.0.4
servers:
- url: https://prod.api.market/api/v1/aedbx/aerodatabox
info:
  title: AeroDataBox API - Aviation and Flight 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
paths:
  /aircrafts/{searchBy}/{searchParam}:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Single Aircraft (by Tail-number, Mode-S or ID) / TIER 1
      description: "*Returns:* Single aircraft, *best* matching specified search criteria, if found. Please note that all found aircraft will be impersonated with registration information matching the requested
        tail number or Mode-S even though an aircraft might be flying under a different registration right now."
      operationId: GetAircraft
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search aircraft by
        schema:
          $ref: "#/components/schemas/AircraftSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `id`: then this field should be an ID of an aircraft (as specified in the database of this API);\r\n* `reg`: then this field should
          be a tail-number of an aircraft (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ), multiple matches are possible - see below;\r\n* `icao24`, then this field
          should be a ICAO 24-bit Mode-S address of an aircraft specified in hexadecimal format (e.g. 484161, 483EFD), multiple matches are possible - see below.\r\n\r\n*If multiple matches are possible:*\r\
          \n\r\nThere cannot be more than one aircraft actively flying with the same tail-number or ICAO 24-bit Mode-S address at any moment of time. \r\nHowever, historically aircraft tail-numbers or addresses
          may be used multiple times by different aircraft.\r\nThis endpoint is supposed to return a **single** aircraft data. In case if multiple aircraft satisfy the search criteria, the best match will
          be chosen as follows:\r\n* If an active aircraft is found according to the requested critera, it is returned.\r\n* Otherwise, an aircraft that used requested tail-number/address the most recently
          is returned. \r\n* If usage time may not be determined, the aircraft stored in the database the most recently is returned."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: withImage
        in: query
        description: "Should include aircraft image (default: false)."
        schema:
          type: boolean
          default: false
      - name: withRegistrations
        in: query
        description: "Should include the history of aircraft registrations (default: false)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AircraftContract"
              examples:
                GetAircraft200Example:
                  summary: Default GetAircraft 200 response
                  x-microcks-default: true
                  value:
                    id: 100
                    reg: N12345
                    active: true
                    serial: example_value
                    hexIcao: KLAX
                    airlineName: Los Angeles International
                    iataType: LAX
                    iataCodeShort: LAX
                    icaoCode: KLAX
                    model: example_value
                    modelCode: CODE1
                    numSeats: 100
                    rolloutDate: '2025-03-15T14:30:00Z'
                    firstFlightDate: '2025-03-15T14:30:00Z'
                    deliveryDate: '2025-03-15T14:30:00Z'
                    registrationDate: '2025-03-15T14:30:00Z'
                    typeName: Los Angeles International
                    numEngines: 100
                    engineType: example_value
                    isFreighter: true
                    productionLine: example_value
                    ageYears: 1.5
                    verified: true
                    image: example_value
                    numRegistrations: 100
                    registrations:
                    - N12345
            application/xml:
              schema:
                $ref: "#/components/schemas/AircraftContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAircraft400Example:
                  summary: Default GetAircraft 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:
                GetAircraft401Example:
                  summary: Default GetAircraft 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:
                GetAircraft451Example:
                  summary: Default GetAircraft 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:
                GetAircraft500Example:
                  summary: Default GetAircraft 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - &a1
      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
  /aircrafts/{searchBy}/{searchParam}/registrations:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Single Aircraft Registration History (by Tail-number, Mode-S or ID) / TIER 1
      description: "*Returns:* A list of all known registrations of a single aircraft, *best* matching specified search criteria, if found"
      operationId: GetAircraftRegistrations
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search aircraft by
        schema:
          $ref: "#/components/schemas/AircraftSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `id`, then this field should be an ID of an aircraft (as specified in the database of this API);\r\n* `reg`, then this field should
          be a tail-number of an aircraft (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ), multiple matches are possible - see below;\r\n* `icao24`, then this field
          should be a ICAO 24-bit Mode-S address of an aircraft specified in hexadecimal format (e.g. 484161, 483EFD), multiple matches are possible - see below.\r\n\r\n*If multiple matches are possible:*
          see similar remark to `Single aircraft` endpoint."
        required: true
        schema:
          maxLength: 10
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/AircraftRegistrationContract"
              examples:
                GetAircraftRegistrations200Example:
                  summary: Default GetAircraftRegistrations 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/AircraftRegistrationContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAircraftRegistrations400Example:
                  summary: Default GetAircraftRegistrations 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:
                GetAircraftRegistrations401Example:
                  summary: Default GetAircraftRegistrations 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:
                GetAircraftRegistrations451Example:
                  summary: Default GetAircraftRegistrations 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:
                GetAircraftRegistrations500Example:
                  summary: Default GetAircraftRegistrations 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /aircrafts/{searchBy}/{searchParam}/all:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Aircraft by Tail-number, Mode-S or ID / TIER 1
      description: "*Returns:* A list of all aircraft ever matched the requested criteria. Please note that all found aircraft will be impersonated with registration information matching the requested tail
        number or Mode-S even though an aircraft might be flying under a different registration right now."
      operationId: GetAllAircraft
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search aircraft by
        schema:
          $ref: "#/components/schemas/AircraftSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `id`, then this field should be an ID of an aircraft (as specified in the database of this API);\r\n* `reg`, then this field should
          be a tail-number of an aircraft (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be a ICAO 24-bit Mode-S address of
          an aircraft specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: withImage
        in: query
        description: "Should include aircraft image (default: false)."
        schema:
          type: boolean
          default: false
      - name: withRegistrations
        in: query
        description: "Should include the history of aircraft registrations (default: false)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/AircraftContract"
              examples:
                GetAllAircraft200Example:
                  summary: Default GetAllAircraft 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/AircraftContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAllAircraft400Example:
                  summary: Default GetAllAircraft 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:
                GetAllAircraft401Example:
                  summary: Default GetAllAircraft 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:
                GetAllAircraft451Example:
                  summary: Default GetAllAircraft 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:
                GetAllAircraft500Example:
                  summary: Default GetAllAircraft 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airlines/{airlineCode}/aircrafts:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Airline Fleet / Aircraft List by Airline Code (BETA) / TIER 3
      description: "*Returns:* A paged list of aircraft in the fleet of the specified airline. \r\n\r\nThat will include *active* aircraft currently flying in an *active* airline, verfified through more
        than one source.\r\nUnconfirmed sightings of an aircraft will not qualify said aircraft to be listed in the fleet."
      operationId: GetAirlineFleet
      parameters:
      - name: airlineCode
        in: path
        description: "3-character ICAO-code of the airliner (e.g., KLM, ACA); or\r\n2-character IATA-code of the airline (e.g., KL, AC).\r\n            \r\nPlease note that more than one active airline
          may have the same IATA code, therefore IATA codes are not recommended for this endpoint."
        required: true
        schema:
          maxLength: 3
          minLength: 2
          type: string
      - name: pageSize
        in: query
        description: "The number of returned records will be capped at this value.\r\nMust be a positive value and not exceed the limit stipulated by your pricing plan."
        required: true
        schema:
          maximum: 2147483647
          minimum: 0
          type: integer
          format: int32
      - name: pageOffset
        in: query
        description: The number of records to skip before listing a page of records. In conjunction with `pageSize` effectively determines the page number (default  - 0).
        schema:
          maximum: 2147483647
          minimum: 0
          type: integer
          format: int32
          default: 0
      - name: withRegistrations
        in: query
        description: "Should include the history of aircraft registrations (default: false)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AircraftContractPagedCollectionContract"
              examples:
                GetAirlineFleet200Example:
                  summary: Default GetAirlineFleet 200 response
                  x-microcks-default: true
                  value:
                    totalCount: 100
                    pageOffset: 100
                    pageSize: 100
                    hasNextPage: true
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AircraftContractPagedCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirlineFleet400Example:
                  summary: Default GetAirlineFleet 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:
                GetAirlineFleet401Example:
                  summary: Default GetAirlineFleet 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:
                GetAirlineFleet451Example:
                  summary: Default GetAirlineFleet 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:
                GetAirlineFleet500Example:
                  summary: Default GetAirlineFleet 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
    parameters:
    - *a1
  /aircrafts/reg/{reg}/image/beta:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Aircraft Image by Tail-number / TIER 2
      description: "**What is the aircraft photo?**\r\n\r\nAircraft images are being searched in external sources by certain criteria without any manual intervention. \r\nTherefore, false matches may be
        returned. Only images with licenses approved for commercial use are returned. Please be advised that you may be required to mention author attribution before using the image.\r\n\r\n*Returns:* Image
        data with medium-sized direct image URL and licence approved for commercial use\r\nis returned."
      operationId: GetAircraftImageByRegistration
      parameters:
      - name: reg
        in: path
        description: Tail-number of the aircraft (full, stripped and any case formats are acceptable).
        required: true
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResourceContract"
              examples:
                GetAircraftImageByRegistration200Example:
                  summary: Default GetAircraftImageByRegistration 200 response
                  x-microcks-default: true
                  value:
                    url: example_value
                    webUrl: example_value
                    author: example_value
                    title: example_value
                    description: example_value
                    license: example_value
                    htmlAttributions:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ResourceContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAircraftImageByRegistration400Example:
                  summary: Default GetAircraftImageByRegistration 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:
                GetAircraftImageByRegistration401Example:
                  summary: Default GetAircraftImageByRegistration 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:
                GetAircraftImageByRegistration451Example:
                  summary: Default GetAircraftImageByRegistration 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:
                GetAircraftImageByRegistration500Example:
                  summary: Default GetAircraftImageByRegistration 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /aircrafts/search/term:
    get:
      tags:
      - Aircraft API
      summary: AeroDataBox Search Active Aircraft Tail Numbers by Term / TIER 2
      description: "*Returns:* List of active aircraft registrations with tail numbers starting from the term."
      operationId: SearchAircraftByTerm
      parameters:
      - name: q
        in: query
        description: Search term (min. 4 non whitespace characters length)
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: Maximum number of items to be returned (max. 10, defaut = 5)
        schema:
          type: integer
          format: int32
          default: 5
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StringAircraftContractSearchResultCollectionContract"
              examples:
                SearchAircraftByTerm200Example:
                  summary: Default SearchAircraftByTerm 200 response
                  x-microcks-default: true
                  value:
                    searchBy: example_value
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/StringAircraftContractSearchResultCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SearchAircraftByTerm400Example:
                  summary: Default SearchAircraftByTerm 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:
                SearchAircraftByTerm401Example:
                  summary: Default SearchAircraftByTerm 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:
                SearchAircraftByTerm451Example:
                  summary: Default SearchAircraftByTerm 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:
                SearchAircraftByTerm500Example:
                  summary: Default SearchAircraftByTerm 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{code}:
    get:
      tags:
      - Airport API
      summary: AeroDataBox Airport by Code / TIER 1
      description: "At the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns*: Single airport data, if found."
      operationId: GetAirport
      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: withRunways
        in: query
        description: Include runways data (default - false)
        schema:
          type: boolean
          default: false
      - name: withTime
        in: query
        description: Include current local time (default - false)
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportContract"
              examples:
                GetAirport200Example:
                  summary: Default GetAirport 200 response
                  x-microcks-default: true
                  value:
                    icao: KLAX
                    iata: LAX
                    localCode: CODE1
                    shortName: Los Angeles International
                    fullName: Los Angeles International
                    municipalityName: Los Angeles International
                    location: example_value
                    elevation: example_value
                    country: example_value
                    continent: example_value
                    timeZone: example_value
                    urls: example_value
                    runways:
                    - example_value
                    currentTime: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirport400Example:
                  summary: Default GetAirport 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:
                GetAirport401Example:
                  summary: Default GetAirport 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:
                GetAirport451Example:
                  summary: Default GetAirport 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:
                GetAirport500Example:
                  summary: Default GetAirport 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{code}/runways:
    get:
      tags:
      - Airport API
      summary: AeroDataBox Airport Runways / TIER 1
      description: "**Which runways does this airport have?**\r\n\r\nAt the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns*: Collection of runway data items."
      operationId: GetAirportRunways
      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:
                type: array
                items:
                  $ref: "#/components/schemas/RunwayContract"
              examples:
                GetAirportRunways200Example:
                  summary: Default GetAirportRunways 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/RunwayContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportRunways400Example:
                  summary: Default GetAirportRunways 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:
                GetAirportRunways401Example:
                  summary: Default GetAirportRunways 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:
                GetAirportRunways451Example:
                  summary: Default GetAirportRunways 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:
                GetAirportRunways500Example:
                  summary: Default GetAirportRunways 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/search/location:
    get:
      tags:
      - Airport API
      summary: AeroDataBox Search Airports by Location / TIER 2
      description: "**What are the airports closest to the location?**\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:* A list
        of airports found within the specified radius around the specified location."
      operationId: SearchAirportsByLocation
      parameters:
      - name: lat
        in: query
        description: Latitude location coordinate in decimal format (between -90 and 90)
        required: true
        schema:
          type: number
          format: float
      - name: lon
        in: query
        description: Longitude location coordinate in decimal format (between -180 and 180)
        required: true
        schema:
          type: number
          format: float
      - name: radiusKm
        in: query
        description: Radius of search around specified location in kilometers (max. 1000 km)
        required: true
        schema:
          type: integer
          format: int32
      - name: limit
        in: query
        description: Maximum number of airports to be returned (max. 250)
        required: true
        schema:
          type: integer
          format: int32
      - name: withFlightInfoOnly
        in: query
        description: If set to true, will only return airports which have flight data (scheduled or live) available. Default = false.
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GeoCoordinatesContractListingAirportContractSearchResultCollectionContract"
              examples:
                SearchAirportsByLocation200Example:
                  summary: Default SearchAirportsByLocation 200 response
                  x-microcks-default: true
                  value:
                    searchBy: example_value
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/GeoCoordinatesContractListingAirportContractSearchResultCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SearchAirportsByLocation400Example:
                  summary: Default SearchAirportsByLocation 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:
                SearchAirportsByLocation401Example:
                  summary: Default SearchAirportsByLocation 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:
                SearchAirportsByLocation451Example:
                  summary: Default SearchAirportsByLocation 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:
                SearchAirportsByLocation500Example:
                  summary: Default SearchAirportsByLocation 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/search/ip:
    get:
      tags:
      - Airport API
      summary: AeroDataBox Search Airports by IP Address Geolocation / TIER 2
      description: "**What are the airports closest to the customer, based on their IP address?**\r\n**What are the airports closest to the location determined (geo-located) by a IP address?**\r\n\r\nThis
        endpoint determines the location by the IP address provided and then returns the list of the nearest airports\r\nin the same way as `Search airports by location` endpoint does. \r\n\r\nPlease note:\r\
        \n* IP geo-location is not a precise method and it determines an approximate location only.\r\n* At the moment airports having both ICAO and IATA code and flight schedules are present available
        only.\r\n\r\n*Returns:* A list of airports found within the specified radius around the location approximated (geo-located) from the specified IP address."
      operationId: SearchAirportsByIpGeoLocation
      parameters:
      - name: q
        in: query
        description: A valid public IP v4 address
        required: true
        schema:
          type: string
      - name: radiusKm
        in: query
        description: Radius of search around specified location in kilometers (max. 1000 km)
        required: true
        schema:
          type: integer
          format: int32
      - name: limit
        in: query
        description: Maximum number of airports to be returned (max. 250)
        required: true
        schema:
          type: integer
          format: int32
      - name: withFlightInfoOnly
        in: query
        description: If set to true, will only return airports which have flight data (scheduled or live) available. Default = false.
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GeoCoordinatesContractListingAirportContractSearchResultCollectionContract"
              examples:
                SearchAirportsByIpGeoLocation200Example:
                  summary: Default SearchAirportsByIpGeoLocation 200 response
                  x-microcks-default: true
                  value:
                    searchBy: example_value
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/GeoCoordinatesContractListingAirportContractSearchResultCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SearchAirportsByIpGeoLocation400Example:
                  summary: Default SearchAirportsByIpGeoLocation 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:
                SearchAirportsByIpGeoLocation401Example:
                  summary: Default SearchAirportsByIpGeoLocation 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:
                SearchAirportsByIpGeoLocation451Example:
                  summary: Default SearchAirportsByIpGeoLocation 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:
                SearchAirportsByIpGeoLocation500Example:
                  summary: Default SearchAirportsByIpGeoLocation 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/search/term:
    get:
      tags:
      - Airport API
      summary: AeroDataBox Search Airports by Free Text / TIER 2
      description: "At the moment airports having both ICAO and IATA code and flight schedules are present available only.\r\n\r\n*Returns:* List of airports with names and city names (and IATA/ICAO code,
        if enabled) matching the search term."
      operationId: SearchAirportByTerm
      parameters:
      - name: q
        in: query
        description: Search query (min. 3 non whitespace characters length)
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: Maximum number of airports to be returned (max. 250, defaut = 10)
        schema:
          type: integer
          format: int32
          default: 10
      - name: withFlightInfoOnly
        in: query
        description: If set to true, will only return airports which have flight data (scheduled or live) available. Default = false.
        schema:
          type: boolean
          default: false
      - name: withSearchByCode
        in: query
        description: "If set to true, will attempt to interpret short words within the search query as IATA or ICAO code\r\nand prioritize exact matches by these codes (they will appear higher than others).
          \r\nOtherwise, the search by code will be completely excluded (only the name of an airport or its city will be searched). \r\nDefault = true."
        schema:
          type: boolean
          default: true
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StringListingAirportContractSearchResultCollectionContract"
              examples:
                SearchAirportByTerm200Example:
                  summary: Default SearchAirportByTerm 200 response
                  x-microcks-default: true
                  value:
                    searchBy: example_value
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/StringListingAirportContractSearchResultCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SearchAirportByTerm400Example:
                  summary: Default SearchAirportByTerm 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:
                SearchAirportByTerm401Example:
                  summary: Default SearchAirportByTerm 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:
                SearchAirportByTerm451Example:
                  summary: Default SearchAirportByTerm 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:
                SearchAirportByTerm500Example:
                  summary: Default SearchAirportByTerm 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/webhook/{subjectType}/{subjectId}:
    post:
      tags:
      - Flight Alert API
      summary: AeroDataBox Create Web-hook Subscription / TIER 4
      description: "*This endpoitns is a part of Flight alert PUSH API currently powered by webhooks.  \r\nIf you are running your own web service, you can subscribe to flights by number or airport code.
        \r\nAfter that, your HTTP endpoint will be called (notified) whenever the flight information gets \r\nupdated.*\r\n\r\nCreates a web-hook subscription on a subject (e.g., flight alerts by number
        or by airport code).\r\nReturns information about created subscription. Subscription ID contained in it\r\ncan be used to refresh or remove it.\r\n\r\nEvery time a subject gets updated, a HTTP request
        will be sent to\r\nthe URL specified in `url` parameter. Request will be of a POST type \r\nand contain JSON-formatted `FlightNotificationContract` object containing subscription\r\nand flights
        information in  the body (see example response for status code 199\r\nof this endpoint documentation).\r\n\r\nAll flight alerts / notifications are delivered in best-effort manner. They might be
        missing\r\nor delayed. If there was an error delivering a notification for any reason, for example, your\r\nendpoint was not available, returned non-2xx status code, or did not respond within timeout
        period,\r\nthere will be 2 more retries after 5 and 15 minutes (**this behavior is changing, see below**).\r\n\r\nIf subscribed to a specific flight or to flights operated in a specific airport:\r\
        \n* Ensure that the flight is within the live updates / ADS-B data coverage. There is no sense in subscribing to a flight which operates in airports having poor or  no live updates or ADS-B coverage:
        there simply will be no updates. To check if an airport is tracked and on which level, use `/health/services/airports/{icao}/feeds` endpoint. You can also use `/health/services/feeds/{service}/airports`
        to get the list of covered airports. Read more about coverage here: https://www.aerodatabox.com/data-coverage.\r\n* Notifications will cover updates for flights commencing from 6 hours ago up to
        72 hours in future.\r\n* Among these, notifications will contain only those flight items which were actually updated this time.\r\n\r\n** ! WARNING OF THE UPCOMING BREAKING CHANGES ! **\r\n\r\n\
        WE ARE CHANGING HOW WEB-HOOK SUBSCRIPTION BILLING AND NOTIFICATION RETRY IS HANDLED. \r\n\r\nIf you're already using Flight Alert API you need to adjust your code to prevent service interruption.\r\
        \n\r\n**CURRENT BEHAVIOR (BEING PHASED OUT):**\r\n\r\n* Web-hook subscriptions created using this endpoint have a life-time of 7 days. Expiration date-time is provided in the response to this endpoint.
        \r\n* After that expiration date the subscription will be removed automatically. If you want to prevent expiration and extend the subscription, use `PATCH /webhook/{subscriptionId}/refresh` endpoint
        to refresh the subscription. You may also remove the subscription manually using DELETE `webhook/{subscriptionId}`.\r\n* As long as a web-hook subscription is active, you will receive notifications
        if there are any.\r\n* You are billed for every call when you create or refresh a subscription as per Tier 4 API quota.\r\n* You are **not** billed for the amount of notifications generated or delivered
        to you.\r\n* You may **not** be refunded for unused time on your subscription if you remove it manually before expiration or if there were no notifications.\r\n* Each failed notification delivery
        attempt is retried 2 times by default, regardless of the reason of failure.\r\n\r\n**UPCOMING BEHAVIOR:**\r\n\r\n* Web-hook subscriptions no longer expire, unless you remove them manually.\r\n*
        This endpoint is moved to the Free Tier and both creating and refreshing subscriptions will be free of charge.\r\n* Every API consumer will now have a dedicated flight alert credit balance separate
        from the API quota. \r\n* Credits are deducted from your balance each time an alert notification is sent to your webhook. The cost is 1 credit per flight item in the notification. If a notification
        contains 1 flight, it costs 1 credit. If a notification contains 5 flights (common with airport subscriptions), it costs 5 credits.\r\n* Use caution when subscribing to an airport with a lot of
        traffic, as it may drain your balance quickly.\r\n* As soon as your balance reaches zero, all your web-hook subscriptions will pause and no notifications will be sent until you refill your balance.The
        balance is shared among all web-hook subscriptions created by you.\r\n* To refill the balance, refer to `POST /subscriptions/balance/refill` API endpoint.\r\n* To check the balance, refer to `GET
        /subscriptions/balance` endpoint.\r\n* `PATCH /webhook/{subscriptionId}/refresh` is now deprecated will be removed after the transition period. Pricing Tier 4 will be discontinued too.\r\n* Each
        failed notification delivery attempt is not retried by default, unless you explicitly set amount of retries when creating the subscription using `maxDeliveryRetries` parameter in the request body.\r\
        \n* Each retry attempt costs the same amount of credits as the original notification delivery attempt.\r\n\r\n**WHEN THE CHANGE WILL HAPPEN?**\r\n\r\n* Transition period will end on **the 4th of
        April, 2026**. Both systems will co-exist during the transition period until then. After that date only the credit-based billing system will remain operational. \r\n\r\n**MIGRATION GUIDE / LEARN
        MORE**\r\n\r\nRead our guide at https://aerodatabox.com/flight-alert-api-2026/"
      operationId: SubscribeWebhook
      parameters:
      - name: subjectType
        in: path
        description: Subject type
        schema:
          $ref: "#/components/schemas/SubscriptionSubjectType"
      - name: subjectId
        in: path
        description: "Subject ID. If `subjectType` is: \r\n* `FlightByNumber`, then this field must be a flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g. KL1395,
          Klm 1395);\r\n* `FlightByAirportIcao`, then this field must be a 4-character ICAO-code of the airport where flights are operated (e.g.: EHAM, KLAX, UUEE, etc.);"
        required: true
        schema:
          type: string
      - name: useCredits
        in: query
        description: "THIS IS A TEMPORARY MIGRATION PARAMETER FOR EASIER TRANSITION. \r\nDefault value: false.\r\nSet to true to create a web-hook subscription under the new, credit-based billing model.In
          this case, the call will be free of charge despite Tier 4.\r\nAfter transition this parameter will be ignored as all subscriptions will be created as credit-based and you will be able to remove
          it."
        schema:
          type: boolean
          default: false
      requestBody:
        description: Command containing parameters for web-hook subscription creation
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateWebHookSubscription"
      responses:
        "199":
          description: Information
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FlightNotificationContract"
              examples:
                SubscribeWebhook199Example:
                  summary: Default SubscribeWebhook 199 response
                  x-microcks-default: true
                  value:
                    flights:
                    - example_value
                    subscription: example_value
                    balance: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/FlightNotificationContract"
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
              examples:
                SubscribeWebhook200Example:
                  summary: Default SubscribeWebhook 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    isActive: true
                    billingType: example_value
                    activateBeforeUtc: '2025-03-15T14:30:00Z'
                    expiresOnUtc: '2025-03-15T14:30:00Z'
                    createdOnUtc: '2025-03-15T14:30:00Z'
                    subject: example_value
                    subscriber: example_value
                    notices:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SubscribeWebhook400Example:
                  summary: Default SubscribeWebhook 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:
                SubscribeWebhook401Example:
                  summary: Default SubscribeWebhook 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:
                SubscribeWebhook451Example:
                  summary: Default SubscribeWebhook 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:
                SubscribeWebhook500Example:
                  summary: Default SubscribeWebhook 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 4
        position: before
        color: "#8a8eb2"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/webhook/{subscriptionId}:
    get:
      tags:
      - Flight Alert API
      summary: AeroDataBox Get Web-hook Subscription / FREE TIER
      description: "*This endpoint is a part of Flight alert PUSH API currently powered by webhooks.  \r\nIf you are running your own web service, you can subscribe to flights by number or airport code.
        \r\nAfter that, your HTTP endpoint will be called (notified) whenever the flight information gets \r\nupdated.*\r\n\r\nGets information about an existing active web-hook subscription."
      operationId: GetWebhook
      parameters:
      - name: subscriptionId
        in: path
        description: Subscription ID
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
              examples:
                GetWebhook200Example:
                  summary: Default GetWebhook 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    isActive: true
                    billingType: example_value
                    activateBeforeUtc: '2025-03-15T14:30:00Z'
                    expiresOnUtc: '2025-03-15T14:30:00Z'
                    createdOnUtc: '2025-03-15T14:30:00Z'
                    subject: example_value
                    subscriber: example_value
                    notices:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetWebhook400Example:
                  summary: Default GetWebhook 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:
                GetWebhook401Example:
                  summary: Default GetWebhook 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:
                GetWebhook451Example:
                  summary: Default GetWebhook 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:
                GetWebhook500Example:
                  summary: Default GetWebhook 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      tags:
      - Flight Alert API
      summary: AeroDataBox Remove Web-hook Subscription / FREE TIER
      description: "*This endpoitns is a part of Flight alert PUSH API currently powered by webhooks.  \r\nIf you are running your own web service, you can subscribe to flights by number or airport code.
        \r\nAfter that, your HTTP endpoint will be called (notified) whenever the flight information gets \r\nupdated.*\r\n\r\nRemoves the subscription"
      operationId: UnsubscribeWebhook
      parameters:
      - name: subscriptionId
        in: path
        description: Subscription ID
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: OK
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                UnsubscribeWebhook400Example:
                  summary: Default UnsubscribeWebhook 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:
                UnsubscribeWebhook401Example:
                  summary: Default UnsubscribeWebhook 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:
                UnsubscribeWebhook451Example:
                  summary: Default UnsubscribeWebhook 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:
                UnsubscribeWebhook500Example:
                  summary: Default UnsubscribeWebhook 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/webhook:
    get:
      tags:
      - Flight Alert API
      summary: AeroDataBox List Web-hook Subscriptions / FREE TIER
      description: "*This endpoitns is a part of Flight alert PUSH API currently powered by webhooks.  \r\nIf you are running your own web service, you can subscribe to flights by number or airport code.
        \r\nAfter that, your HTTP endpoint will be called (notified) whenever the flight information gets \r\nupdated.*\r\n\r\nGet the list of existing active web-hook subscriptions"
      operationId: GetWebhookList
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/SubscriptionContract"
              examples:
                GetWebhookList200Example:
                  summary: Default GetWebhookList 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/SubscriptionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetWebhookList400Example:
                  summary: Default GetWebhookList 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:
                GetWebhookList401Example:
                  summary: Default GetWebhookList 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:
                GetWebhookList451Example:
                  summary: Default GetWebhookList 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:
                GetWebhookList500Example:
                  summary: Default GetWebhookList 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/webhook/{subscriptionId}/refresh:
    patch:
      tags:
      - Flight Alert API
      summary: AeroDataBox Refresh Web-hook Subscription (DEPRECATED) / TIER 4
      description: " *This endpoitns is a part of Flight alert PUSH API currently powered by webhooks.  \r\n If you are running your own web service, you can subscribe to flights by number or airport code.
        \r\n After that, your HTTP endpoint will be called (notified) whenever the flight information gets \r\n updated.*\r\n \r\n Refreshes an existing web-hook subscription\r\n \r\n If the subscription
        had an expiration date-time set when created, this endpoint \r\n will extend it by the same period of time as the one it was originally created with. \r\n E.g., if subscription was originally created
        for 7 days, this endpoint will\r\n add extra 7 days to the expiration date-time. Note, that web-hook subscriptions\r\n cannot be extended beyond the sliding window of 60 days from the current date-time.
        \r\n \r\n If the subscription had no expiration date-time set, nothing occurs.\r\n \r\n **! WARNING OF THE UPCOMING BREAKING CHANGES !**\r\n \r\n DUE TO TRANSITIONING TO A NEW CREDIT-BASED BILLING
        MODEL FOR WEB-HOOK SUBSCRIPTIONS, \r\n\tTHIS ENDPOINT WILL BE DEPRECATED AND REMOVED LATER ON.\r\n\r\n **MIGRATION GUIDE / LEARN MORE**\r\n \r\n Read our guide at https://aerodatabox.com/flight-alert-api-2026/"
      operationId: RefreshWebhook
      parameters:
      - name: subscriptionId
        in: path
        description: Subscription ID
        required: true
        schema:
          type: string
          format: uuid
      - name: useCredits
        in: query
        description: "THIS IS A TEMPORARY MIGRATION PARAMETER FOR EASIER TRANSITION. \r\nDefault value: false.\r\nSet to true to refresh an existing web-hook subscription under the new, credit-based billing
          model. In this case, the call will be free of charge despite Tier 4."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
              examples:
                RefreshWebhook200Example:
                  summary: Default RefreshWebhook 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    isActive: true
                    billingType: example_value
                    activateBeforeUtc: '2025-03-15T14:30:00Z'
                    expiresOnUtc: '2025-03-15T14:30:00Z'
                    createdOnUtc: '2025-03-15T14:30:00Z'
                    subject: example_value
                    subscriber: example_value
                    notices:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/SubscriptionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                RefreshWebhook400Example:
                  summary: Default RefreshWebhook 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:
                RefreshWebhook401Example:
                  summary: Default RefreshWebhook 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:
                RefreshWebhook451Example:
                  summary: Default RefreshWebhook 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:
                RefreshWebhook500Example:
                  summary: Default RefreshWebhook 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      deprecated: true
      x-badges:
      - name: TIER 4
        position: before
        color: "#8a8eb2"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/balance:
    get:
      tags:
      - Flight Alert API
      summary: AeroDataBox Get Web-hook Subscription Balance / FREE TIER
      description: "The current web-hook subscription balance information.\r\nThis is separate from your API marketplace quota and is used solely for billing of web-hook subscriptions.\r\nFor more details
        about how flight alert API billing works, refer to our guide at https://aerodatabox.com/flight-alert-api-2026/"
      operationId: GetBalance
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionBalanceContract"
              examples:
                GetBalance200Example:
                  summary: Default GetBalance 200 response
                  x-microcks-default: true
                  value:
                    creditsRemaining: 100
                    lastRefilledUtc: '2025-03-15T14:30:00Z'
                    lastDeductedUtc: '2025-03-15T14:30:00Z'
            application/xml:
              schema:
                $ref: "#/components/schemas/SubscriptionBalanceContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetBalance400Example:
                  summary: Default GetBalance 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:
                GetBalance401Example:
                  summary: Default GetBalance 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:
                GetBalance451Example:
                  summary: Default GetBalance 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:
                GetBalance500Example:
                  summary: Default GetBalance 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /subscriptions/balance/refill:
    post:
      tags:
      - Flight Alert API
      summary: AeroDataBox Refill Web-hook Subscription Balance / TIER 1
      description: "Performs refill operation on the web-hook subscription balance by the specified amount of credits.\r\nThis balance is separate from your API marketplace quota and is used solely for
        billing of web-hook subscriptions.\r\n\r\nIn the request body, you specify how many credits you want to add. This is a variable-rate endpoint and the amount of API units \r\ndeducted from your API
        quota depends on the amount of flight alerts credits requested.\r\nThe conversion rate is: 1 credit = 1 API unit.\r\n\r\nAdditional limits apply with regard to how many credits you can request per
        single refill operation and how many credits\r\nyou can have in your balance at any given time. These limits depend on your pricing plan (https://aerodatabox.com/pricing).\r\n\r\nFor more details
        about how flight alert API billing works, refer to our guide at https://aerodatabox.com/flight-alert-api-2026/"
      operationId: RefillBalance
      requestBody:
        description: The details of the balance refill operation, including the amount of credits to add.
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SubscriptionsBalanceRefillRequestContract"
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionBalanceContract"
              examples:
                RefillBalance200Example:
                  summary: Default RefillBalance 200 response
                  x-microcks-default: true
                  value:
                    creditsRemaining: 100
                    lastRefilledUtc: '2025-03-15T14:30:00Z'
                    lastDeductedUtc: '2025-03-15T14:30:00Z'
            application/xml:
              schema:
                $ref: "#/components/schemas/SubscriptionBalanceContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                RefillBalance400Example:
                  summary: Default RefillBalance 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:
                RefillBalance401Example:
                  summary: Default RefillBalance 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:
                RefillBalance451Example:
                  summary: Default RefillBalance 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:
                RefillBalance500Example:
                  summary: Default RefillBalance 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/{searchBy}/{searchParam}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Flight Status (single Day) / TIER 2
      description: "**What is the status of a specific flight?**\r\n**What is the historical status or schedule of a specific flight on a specific date in past or in future?**\r\n\r\nThis endpoint returns
        data about a specific flight  live flight status (if the flight is within the coverage and not in distant future), \r\nor flight schedule data otherwise.\r\n\r\nIf `dateLocal` is specified, gets
        data about flight(s) departing or arriving on the day specified (local time).\r\nOtherwise, gets data about the status of flight(s) operating on the nearest date (either in past or in future).\r\
        \n\r\nA flight can be searched by:\r\n* flight number it's being operated under; or\r\n* ATC-callsign it's being operated under; or\r\n* tail-number of the aircraft it's being operated by; or\r\n\
        * Mode-S 24-bit ICAO Transponder address of the aircraft it's being operated by.\r\n\r\nFlight data may include airport of arrival and departure, scheduled and actual times, flight status, type
        of aircraft, \r\ntail-number and aircraft image.\r\n\r\nSome flights may have partial data. The data may be absent for either arrival \r\nor departure airport or may not include live updates of
        time and status. Check quality markers inside the response to \r\ndetermine which data is available.\r\n\r\nNormally, information with live status updates and estimated/actual arrival/departure
        times is only available \r\nfor airports tracked live or with ADS-B by our system. Otherwise flight information will be with scheduled info only \r\nor absent. \r\n\r\nTo check if an airport is
        currently 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\nRead more about coverage and flight data limitations here: https://www.aerodatabox.com/data-coverage."
      operationId: GetFlight_FlightNearest
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search flight by
        schema:
          $ref: "#/components/schemas/FlightSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `number`, then this field shoud be Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g.
          KL1395, Klm 1395)\r\n* `callsign`, then this field should be ATC call-sign of the flight (with or without spaces, any case formats are acceptable, e.g.AFL1482, nca 008X);\r\n* `reg`, then this
          field should be Aircraft tail-number (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be Aircraft ICAO 24-bit Mode-S
          address specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: dateLocalRole
        in: query
        description: "* If set to `Both` (default, recommended for best results) then the dateLocal parameter shall be considered as both departure and arrival date. If a flight departs OR arrives on that
          date (in the local timezone of the origin or destination, respectively), it will be returned.\r\n* If set to `Departure` then the dateLocal parameter shall be considered as departure date only.
          Only the flights departing on that date (in the local timezone of origin) will be returned.\r\n* If set to `Arrival` then the dateLocal parameter shall be considered as arrival date only. Only
          the flights arriving on that date (in the local timezone of destination) will be returned."
        schema:
          $ref: "#/components/schemas/FlightDirection"
      - name: withAircraftImage
        in: query
        description: "Should include aircraft image (default: false).\r\n\r\nAircraft images are being searched in external sources by certain criteria without any manual intervention. \r\nTherefore, false
          matches may be returned. Only images with licenses approved for commercial use are returned. \r\nPlease be advised that you may be required to mention author attribution before using the image."
        schema:
          type: boolean
          default: false
      - name: withLocation
        in: query
        description: "Should include real-time positional data, e.g.: location, speed, altitude, etc., if available (default: false)."
        schema:
          type: boolean
          default: false
      - name: withFlightPlan
        in: query
        description: "Should include the flight plan filed with the ATC for the flight (default: false).\r\n\r\n* NOTE 1: Generally availabe to flights departing from, arriving to or crossing the mainland
          U.S. airspace.\r\n* NOTE 2: Only available on Basic and Ultra, Ultra-2 and Mega pricing plans.\r\n* NOTE 3: If set to true and the flight plan is found for one or more flights returned, **the
          request will be billed as 2 requests** against your API quota (except on Mega plan)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
              examples:
                GetFlight_FlightNearest200Example:
                  summary: Default GetFlight_FlightNearest 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlight_FlightNearest400Example:
                  summary: Default GetFlight_FlightNearest 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:
                GetFlight_FlightNearest401Example:
                  summary: Default GetFlight_FlightNearest 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:
                GetFlight_FlightNearest451Example:
                  summary: Default GetFlight_FlightNearest 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:
                GetFlight_FlightNearest500Example:
                  summary: Default GetFlight_FlightNearest 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/{searchBy}/{searchParam}/{dateLocal}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Flight Status (single Day) / TIER 2
      description: "**What is the status of a specific flight?**\r\n**What is the historical status or schedule of a specific flight on a specific date in past or in future?**\r\n\r\nThis endpoint returns
        data about a specific flight  live flight status (if the flight is within the coverage and not in distant future), \r\nor flight schedule data otherwise.\r\n\r\nIf `dateLocal` is specified, gets
        data about flight(s) departing or arriving on the day specified (local time).\r\nOtherwise, gets data about the status of flight(s) operating on the nearest date (either in past or in future).\r\
        \n\r\nA flight can be searched by:\r\n* flight number it's being operated under; or\r\n* ATC-callsign it's being operated under; or\r\n* tail-number of the aircraft it's being operated by; or\r\n\
        * Mode-S 24-bit ICAO Transponder address of the aircraft it's being operated by.\r\n\r\nFlight data may include airport of arrival and departure, scheduled and actual times, flight status, type
        of aircraft, \r\ntail-number and aircraft image.\r\n\r\nSome flights may have partial data. The data may be absent for either arrival \r\nor departure airport or may not include live updates of
        time and status. Check quality markers inside the response to \r\ndetermine which data is available.\r\n\r\nNormally, information with live status updates and estimated/actual arrival/departure
        times is only available \r\nfor airports tracked live or with ADS-B by our system. Otherwise flight information will be with scheduled info only \r\nor absent. \r\n\r\nTo check if an airport is
        currently 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\nRead more about coverage and flight data limitations here: https://www.aerodatabox.com/data-coverage."
      operationId: GetFlight_FlightOnSpecificDate
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search flight by
        schema:
          $ref: "#/components/schemas/FlightSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `number`, then this field shoud be Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g.
          KL1395, Klm 1395)\r\n* `callsign`, then this field should be ATC call-sign of the flight (with or without spaces, any case formats are acceptable, e.g.AFL1482, nca 008X);\r\n* `reg`, then this
          field should be Aircraft tail-number (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be Aircraft ICAO 24-bit Mode-S
          address specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: dateLocal
        in: path
        description: "Local date of departure or arrival (in format: YYYY-MM-DD, e.g.: 2019-08-29). Maximum/minimum allowable date is determined by the current data coverage limitations and your pricing
          plan."
        required: true
        schema:
          pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
          type: string
          format: date-time
      - name: dateLocalRole
        in: query
        description: "* If set to `Both` (default, recommended for best results) then the dateLocal parameter shall be considered as both departure and arrival date. If a flight departs OR arrives on that
          date (in the local timezone of the origin or destination, respectively), it will be returned.\r\n* If set to `Departure` then the dateLocal parameter shall be considered as departure date only.
          Only the flights departing on that date (in the local timezone of origin) will be returned.\r\n* If set to `Arrival` then the dateLocal parameter shall be considered as arrival date only. Only
          the flights arriving on that date (in the local timezone of destination) will be returned."
        schema:
          $ref: "#/components/schemas/FlightDirection"
      - name: withAircraftImage
        in: query
        description: "Should include aircraft image (default: false).\r\n\r\nAircraft images are being searched in external sources by certain criteria without any manual intervention. \r\nTherefore, false
          matches may be returned. Only images with licenses approved for commercial use are returned. \r\nPlease be advised that you may be required to mention author attribution before using the image."
        schema:
          type: boolean
          default: false
      - name: withLocation
        in: query
        description: "Should include real-time positional data, e.g.: location, speed, altitude, etc., if available (default: false)."
        schema:
          type: boolean
          default: false
      - name: withFlightPlan
        in: query
        description: "Should include the flight plan filed with the ATC for the flight (default: false).\r\n\r\n* NOTE 1: Generally availabe to flights departing from, arriving to or crossing the mainland
          U.S. airspace.\r\n* NOTE 2: Only available on Basic and Ultra, Ultra-2 and Mega pricing plans.\r\n* NOTE 3: If set to true and the flight plan is found for one or more flights returned, **the
          request will be billed as 2 requests** against your API quota (except on Mega plan)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
              examples:
                GetFlight_FlightOnSpecificDate200Example:
                  summary: Default GetFlight_FlightOnSpecificDate 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlight_FlightOnSpecificDate400Example:
                  summary: Default GetFlight_FlightOnSpecificDate 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:
                GetFlight_FlightOnSpecificDate401Example:
                  summary: Default GetFlight_FlightOnSpecificDate 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:
                GetFlight_FlightOnSpecificDate451Example:
                  summary: Default GetFlight_FlightOnSpecificDate 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:
                GetFlight_FlightOnSpecificDate500Example:
                  summary: Default GetFlight_FlightOnSpecificDate 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/{searchBy}/{searchParam}/{dateFromLocal}/{dateToLocal}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Flight History and Schedule (range of Days) / TIER 3
      description: "**What is the history or schedule of a specific flight within a specific range of dates in past or in future?**\r\n\r\nThis endpoint is the similar to the `Flight status` endpoint. \r\
        \nThe only difference is that instead of returning the flight data on a single date, it returns the data over a range of dates, thus\r\nallowing to get insights on the flight history or schedule
        within the specified range.\r\n\r\nAll limitations and considerations applicable to `Flight status` endpoint are applicable to this endpoint as well."
      operationId: GetFlightHistory_FlightHistory
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search flight by
        schema:
          $ref: "#/components/schemas/FlightSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If `searchBy` is: \r\n* `number`, then this field shoud be Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g.
          KL1395, Klm 1395)\r\n* `callsign`, then this field should be ATC call-sign of the flight (with or without spaces, any case formats are acceptable, e.g.AFL1482, nca 008X);\r\n* `reg`, then this
          field should be Aircraft tail-number (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be Aircraft ICAO 24-bit Mode-S
          address specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: dateFromLocal
        in: path
        description: "Beginning of the range of local dates of departure or arrival (in format: YYYY-MM-DD, e.g.: 2019-08-29). Maximum/minimum allowable value is determined by the current data coverage
          limitations and your pricing plan."
        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: "End of the range of local dates of departure or arrival (in format: YYYY-MM-DD, e.g.: 2019-08-29). Maximum/minimum allowable value is determined by the current data coverage limitations
          and your pricing plan. This date must be bigger than the dateFromLocal. The maximum difference between this date and dateFromLocal is limited and is determined by your pricing plan (ranging from
          7 to 30 days as per moment of writing)."
        required: true
        schema:
          pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
          type: string
          format: date-time
      - name: dateLocalRole
        in: query
        description: "* If set to `Both` (default, recommended for best results) then the dateFromLocal and dateToLocal parameters shall be considered as both departure and arrival dates. If a flight departs
          OR arrives on dates within the specified range (in the local timezone of the origin or destination, respectively), it will be returned.\r\n* If set to `Departure` then the dateFromLocal and dateToLocal\
          \  parameters shall be considered as departure dates only. Only the flights departing on dates within the specified rang(in the local timezone of origin) will be returned.\r\n* If set to `Arrival`
          then the dateFromLocal and dateToLocal  parameters shall be considered as arrival dates only. Only the flights arriving on dates within the specified rangd (in the local timezone of destination)
          will be returned."
        schema:
          $ref: "#/components/schemas/FlightDirection"
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
              examples:
                GetFlightHistory_FlightHistory200Example:
                  summary: Default GetFlightHistory_FlightHistory 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/FlightContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlightHistory_FlightHistory400Example:
                  summary: Default GetFlightHistory_FlightHistory 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:
                GetFlightHistory_FlightHistory401Example:
                  summary: Default GetFlightHistory_FlightHistory 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:
                GetFlightHistory_FlightHistory451Example:
                  summary: Default GetFlightHistory_FlightHistory 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:
                GetFlightHistory_FlightHistory500Example:
                  summary: Default GetFlightHistory_FlightHistory 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
    parameters:
    - *a1
  /flights/{searchBy}/{searchParam}/dates:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Flight Departure Dates / TIER 2
      description: "**On which days the flight operates?** or **What is the flight schedule?**\r\n\r\nFlight can be searched by:\r\n* flight number it's being operated under; or\r\n* ATC-callsign it's being
        operated under; or\r\n* tail-number of the aircraft it's being operated by; or\r\n* Mode-S 24-bit ICAO Transponder address of the aircraft it's being operated by.\r\n\r\n*Returns:* Array of local
        departure dates in (YYYY-MM-DD) format for flights operated under speified call-sign and within the time range specified."
      operationId: GetFlightDates_FlightDatesAll
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search flight by
        schema:
          $ref: "#/components/schemas/FlightSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If **searchBy** is: \r\n* `number`, then this field shoud be Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g.
          KL1395, Klm 1395)\r\n* `callsign`, then this field should be ATC call-sign of the flight (with or without spaces, any case formats are acceptable, e.g.AFL1482, nca 008X);\r\n* `reg`: then this
          field should be Aircraft tail-number (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be Aircraft ICAO 24-bit Mode-S
          address specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              examples:
                GetFlightDates_FlightDatesAll200Example:
                  summary: Default GetFlightDates_FlightDatesAll 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  type: string
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlightDates_FlightDatesAll400Example:
                  summary: Default GetFlightDates_FlightDatesAll 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:
                GetFlightDates_FlightDatesAll401Example:
                  summary: Default GetFlightDates_FlightDatesAll 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:
                GetFlightDates_FlightDatesAll451Example:
                  summary: Default GetFlightDates_FlightDatesAll 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:
                GetFlightDates_FlightDatesAll500Example:
                  summary: Default GetFlightDates_FlightDatesAll 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/{searchBy}/{searchParam}/dates/{fromLocal}/{toLocal}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Flight Departure Dates / TIER 2
      description: "**On which days the flight operates?** or **What is the flight schedule?**\r\n\r\nFlight can be searched by:\r\n* flight number it's being operated under; or\r\n* ATC-callsign it's being
        operated under; or\r\n* tail-number of the aircraft it's being operated by; or\r\n* Mode-S 24-bit ICAO Transponder address of the aircraft it's being operated by.\r\n\r\n*Returns:* Array of local
        departure dates in (YYYY-MM-DD) format for flights operated under speified call-sign and within the time range specified."
      operationId: GetFlightDates_FlightDatesInRange
      parameters:
      - name: searchBy
        in: path
        description: Criteria to search flight by
        schema:
          $ref: "#/components/schemas/FlightSearchByEnum"
      - name: searchParam
        in: path
        description: "Value of the search criteria. If **searchBy** is: \r\n* `number`, then this field shoud be Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g.
          KL1395, Klm 1395)\r\n* `callsign`, then this field should be ATC call-sign of the flight (with or without spaces, any case formats are acceptable, e.g.AFL1482, nca 008X);\r\n* `reg`: then this
          field should be Aircraft tail-number (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ);\r\n* `icao24`, then this field should be Aircraft ICAO 24-bit Mode-S
          address specified in hexadecimal format (e.g. 484161, 483EFD)."
        required: true
        schema:
          maxLength: 10
          type: string
      - name: fromLocal
        in: path
        description: "Beginning of the search range (local time, format: YYYY-MM-DD)"
        required: true
        schema:
          pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
          type: string
          format: date-time
      - name: toLocal
        in: path
        description: "End of the search range (local time, format: YYYY-MM-DD)"
        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:
                  type: string
              examples:
                GetFlightDates_FlightDatesInRange200Example:
                  summary: Default GetFlightDates_FlightDatesInRange 200 response
                  x-microcks-default: true
                  value:
                  - example_value
            application/xml:
              schema:
                type: array
                items:
                  type: string
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlightDates_FlightDatesInRange400Example:
                  summary: Default GetFlightDates_FlightDatesInRange 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:
                GetFlightDates_FlightDatesInRange401Example:
                  summary: Default GetFlightDates_FlightDatesInRange 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:
                GetFlightDates_FlightDatesInRange451Example:
                  summary: Default GetFlightDates_FlightDatesInRange 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:
                GetFlightDates_FlightDatesInRange500Example:
                  summary: Default GetFlightDates_FlightDatesInRange 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/airports/{codeType}/{code}/{fromLocal}/{toLocal}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox FIDS (airport Departures and Arrivals) - by Local Time Range / TIER 2
      description: "**What are current departures or arrivals at the airport?** or **What is the flight schedule at the airport?** or **What is flight history at the airport?**\r\n\r\nFlights may contain
        live updates with corresponding information related to the actual progress of the flight \r\n(including actual/estimated arrival/departure times). In this case this endpoint serves as a FIDS endpoint.
        \r\nPresense of live updates is subject to data coverage: not all airports have this coverage in our system.\r\n\r\nOtherwise flight information will be limited to scheduled only and will not be
        updated real-time. Much more airports\r\nhave this type of coverage. To check if airport is tracked and on which level, use */health/services/airports/{icao}/feeds* endpoint. \r\nYou can also use
        */health/services/feeds/{service}/airports* to get the list of supported airports for this\r\nor that layer of coverage. To learn more about the data coverage, refer to *https://www.aerodatabox.com/data-coverage*.\r\
        \n\r\n*Returns*: the list of arriving and/or departing flights scheduled and/or planned and/or commenced within a specified \r\ntime range for a specified airport."
      operationId: GetAirportFlights
      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: fromLocal
        in: path
        description: "Beginning of the search range (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: toLocal
        in: path
        description: "End of the search range (local time, format: YYYY-MM-DDTHH:mm). Must be more than beginning of the search range by no more than 12 hours."
        required: true
        schema:
          pattern: \d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?
          type: string
          format: date-time
      - name: direction
        in: query
        description: "Direction of flights: Arrival, Departure or Both (default)"
        schema:
          $ref: "#/components/schemas/FlightDirection"
      - name: withLeg
        in: query
        description: "If set to true, the result will include movement information from airport opposite in this flight leg (airport of origin for arriving flight or airport of destination for departing
          flight).\r\nIn this case, Movement property will be replaced with Departure and Arrival properties for each flight.\r\nDefault: false."
        schema:
          type: boolean
          default: false
      - name: withCancelled
        in: query
        description: "If set to true, result will include cancelled, divered, likely cancelled (CanceledUncertain) flights.\r\nDefault: true."
        schema:
          type: boolean
          default: true
      - name: withCodeshared
        in: query
        description: "If set to true, the result will include flights with all code-shared statuses.\r\nOtherwise, code-sharing flights will be exclued. For airports, where no information about code-share
          statuses\r\nof flights are supplied (all flights are CodeshareStatus=Unknown), complex filtering will be applied \r\nto determine which flights are likely to be operational (caution: false results
          are possible)."
        schema:
          type: boolean
          default: true
      - name: withCargo
        in: query
        description: If set to true, the result will include cargo flights (subject to availability).
        schema:
          type: boolean
          default: true
      - name: withPrivate
        in: query
        description: If set to true, the result will include private flights (subject to availability).
        schema:
          type: boolean
          default: true
      - name: withLocation
        in: query
        description: "If set to true, each currently active flight within the result will be populated \r\nwith its present real-time location, altitude, speed and track (subject to availability)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportFidsContract"
              examples:
                GetAirportFlights200Example:
                  summary: Default GetAirportFlights 200 response
                  x-microcks-default: true
                  value:
                    departures:
                    - example_value
                    arrivals:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportFidsContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportFlights400Example:
                  summary: Default GetAirportFlights 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:
                GetAirportFlights401Example:
                  summary: Default GetAirportFlights 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:
                GetAirportFlights451Example:
                  summary: Default GetAirportFlights 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:
                GetAirportFlights500Example:
                  summary: Default GetAirportFlights 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/airports/{codeType}/{code}:
    get:
      tags:
      - Flight API
      summary: AeroDataBox FIDS (airport Departures and Arrivals) - by Relative Time / by Current Time / TIER 2
      description: "**What are current departures or arrivals at the airport?** or **What is the flight schedule at the airport?** or **What is flight history at the airport?**\r\n\r\nFlights may contain
        live updates with corresponding information related to the actual progress of the flight \r\n(including actual/estimated arrival/departure times). In this case this endpoint serves as a FIDS endpoint.
        \r\nPresense of live updates is subject to data coverage: not all airports have this coverage in our system.\r\n\r\nOtherwise flight information will be limited to scheduled only and will not be
        updated real-time. Much more airports\r\nhave this type of coverage. To check if airport is tracked and on which level, use */health/services/airports/{icao}/feeds* endpoint. \r\nYou can also use
        */health/services/feeds/{service}/airports* to get the list of supported airports for this\r\nor that layer of coverage. To learn more about the data coverage, refer to *https://www.aerodatabox.com/data-coverage*.\r\
        \n\r\n*Returns*: the list of arriving and/or departing flights scheduled and/or planned and/or commenced within a time range specified \r\nrelatively to the current local time at the airport."
      operationId: GetAirportFlightsRelative
      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: offsetMinutes
        in: query
        description: "Beginning of the search range expressed in minutes relative to the current time at the airport (default: `-120`)"
        schema:
          type: integer
          format: int64
          default: -120
      - name: durationMinutes
        in: query
        description: "Length (duration) of the search range expressed in minutes (default: `720`)"
        schema:
          type: integer
          format: int64
          default: 720
      - name: direction
        in: query
        description: "Direction of flights: Arrival, Departure or Both (default)"
        schema:
          $ref: "#/components/schemas/FlightDirection"
      - name: withLeg
        in: query
        description: "If set to true, the result will include movement information from airport opposite in this flight leg (airport of origin for arriving flight or airport of destination for departing
          flight).\r\nIn this case, Movement property will be replaced with Departure and Arrival properties for each flight.\r\nDefault: false."
        schema:
          type: boolean
          default: false
      - name: withCancelled
        in: query
        description: "If set to true, result will include cancelled, divered, likely cancelled (CanceledUncertain) flights.\r\nDefault: true."
        schema:
          type: boolean
          default: true
      - name: withCodeshared
        in: query
        description: "If set to true, the result will include flights with all code-shared statuses.\r\nOtherwise, code-sharing flights will be exclued. For airports, where no information about code-share
          statuses\r\nof flights are supplied (all flights are CodeshareStatus=Unknown), complex filtering will be applied \r\nto determine which flights are likely to be operational (caution: false results
          are possible)."
        schema:
          type: boolean
          default: true
      - name: withCargo
        in: query
        description: If set to true, the result will include cargo flights (subject to availability).
        schema:
          type: boolean
          default: true
      - name: withPrivate
        in: query
        description: If set to true, the result will include private flights (subject to availability).
        schema:
          type: boolean
          default: true
      - name: withLocation
        in: query
        description: "If set to true, each currently active flight within the result will be populated \r\nwith its present real-time location, altitude, speed and track (subject to availability)."
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportFidsContract"
              examples:
                GetAirportFlightsRelative200Example:
                  summary: Default GetAirportFlightsRelative 200 response
                  x-microcks-default: true
                  value:
                    departures:
                    - example_value
                    arrivals:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportFidsContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportFlightsRelative400Example:
                  summary: Default GetAirportFlightsRelative 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:
                GetAirportFlightsRelative401Example:
                  summary: Default GetAirportFlightsRelative 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:
                GetAirportFlightsRelative451Example:
                  summary: Default GetAirportFlightsRelative 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:
                GetAirportFlightsRelative500Example:
                  summary: Default GetAirportFlightsRelative 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /flights/search/term:
    get:
      tags:
      - Flight API
      summary: AeroDataBox Search Flight Numbers by Term / TIER 2
      description: "*Returns:* Distinct list of available flight numbers which start with the search query."
      operationId: SearchFlightsByTerm
      parameters:
      - name: q
        in: query
        description: Search query (min. 2 non whitespace characters length)
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: Maximum number of items to be returned (max. 100, defaut = 10)
        schema:
          type: integer
          format: int32
          default: 10
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StringFlightSearchItemContractSearchResultCollectionContract"
              examples:
                SearchFlightsByTerm200Example:
                  summary: Default SearchFlightsByTerm 200 response
                  x-microcks-default: true
                  value:
                    searchBy: example_value
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/StringFlightSearchItemContractSearchResultCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                SearchFlightsByTerm400Example:
                  summary: Default SearchFlightsByTerm 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:
                SearchFlightsByTerm401Example:
                  summary: Default SearchFlightsByTerm 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:
                SearchFlightsByTerm451Example:
                  summary: Default SearchFlightsByTerm 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:
                SearchFlightsByTerm500Example:
                  summary: Default SearchFlightsByTerm 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /health/services/feeds/{service}:
    get:
      tags:
      - Healthcheck API
      summary: AeroDataBox General Status of Data Feed Services / FREE TIER
      description: "**Which is the general health of the data feed service?**\r\n \r\n*Returns:* Status of the service in general, regardless of the airports"
      operationId: GetFeedServiceStatus
      parameters:
      - name: service
        in: path
        description: Data feed service name
        schema:
          $ref: "#/components/schemas/FeedServiceEnum"
      - name: withHttpCode
        in: query
        description: If true, reflect status of the service in the HTTP code of the response (if the service is down, HTTP code will be 503).
        schema:
          type: boolean
          default: false
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FeedServiceStatusContract"
              examples:
                GetFeedServiceStatus200Example:
                  summary: Default GetFeedServiceStatus 200 response
                  x-microcks-default: true
                  value:
                    service: example_value
                    status: Departed
                    minAvailableLocalDate: '2025-03-15T14:30:00Z'
                    maxAvailableLocalDate: '2025-03-15T14:30:00Z'
            application/xml:
              schema:
                $ref: "#/components/schemas/FeedServiceStatusContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFeedServiceStatus400Example:
                  summary: Default GetFeedServiceStatus 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:
                GetFeedServiceStatus401Example:
                  summary: Default GetFeedServiceStatus 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:
                GetFeedServiceStatus451Example:
                  summary: Default GetFeedServiceStatus 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:
                GetFeedServiceStatus500Example:
                  summary: Default GetFeedServiceStatus 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FeedServiceStatusContract"
              examples:
                GetFeedServiceStatus503Example:
                  summary: Default GetFeedServiceStatus 503 response
                  x-microcks-default: true
                  value:
                    service: example_value
                    status: Departed
                    minAvailableLocalDate: '2025-03-15T14:30:00Z'
                    maxAvailableLocalDate: '2025-03-15T14:30:00Z'
            application/xml:
              schema:
                $ref: "#/components/schemas/FeedServiceStatusContract"
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /health/services/airports/{icao}/feeds:
    get:
      tags:
      - Healthcheck API
      summary: AeroDataBox Data Feed Services Status by ICAO Code / FREE TIER
      description: "**What is the status of data updates for the airport?**\r\n\r\nAt the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns:* Current status of
        airport data feed services (live flight updates, flight schedules, etc.) for requested airport."
      operationId: GetAirportFeedStatus
      parameters:
      - name: icao
        in: path
        description: "4-digit ICAO-code of the airport (e.g.: EHAM, KLAX, UUEE, etc.). Full, stripped and any case formats are acceptable."
        required: true
        schema:
          maxLength: 4
          minLength: 4
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportFeedServiceStatusContract"
              examples:
                GetAirportFeedStatus200Example:
                  summary: Default GetAirportFeedStatus 200 response
                  x-microcks-default: true
                  value:
                    flightSchedulesFeed: example_value
                    liveFlightUpdatesFeed: example_value
                    adsbUpdatesFeed: example_value
                    generalAvailability: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportFeedServiceStatusContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportFeedStatus400Example:
                  summary: Default GetAirportFeedStatus 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:
                GetAirportFeedStatus401Example:
                  summary: Default GetAirportFeedStatus 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:
                GetAirportFeedStatus451Example:
                  summary: Default GetAirportFeedStatus 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:
                GetAirportFeedStatus500Example:
                  summary: Default GetAirportFeedStatus 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /health/services/feeds/{service}/airports:
    get:
      tags:
      - Healthcheck API
      summary: AeroDataBox Airports Supporting Data Feed Service / FREE TIER
      description: "**Which airports support flight schedules?** or **Which airports support live flight updates?**\r\n\r\n At the moment airports having both ICAO and IATA code are present in database
        only.\r\n \r\n*Returns:* Collection ICAO codes of airports supporting specified airport data feed service."
      operationId: GetFeedAirports
      parameters:
      - name: service
        in: path
        description: Airport data feed service name
        schema:
          $ref: "#/components/schemas/FeedServiceEnum"
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StringCollectionContract"
              examples:
                GetFeedAirports200Example:
                  summary: Default GetFeedAirports 200 response
                  x-microcks-default: true
                  value:
                    count: 100
                    items:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/StringCollectionContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFeedAirports400Example:
                  summary: Default GetFeedAirports 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:
                GetFeedAirports401Example:
                  summary: Default GetFeedAirports 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:
                GetFeedAirports451Example:
                  summary: Default GetFeedAirports 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:
                GetFeedAirports500Example:
                  summary: Default GetFeedAirports 500 response
                  x-microcks-default: true
                  value:
                    message: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/ErrorContract"
        "503":
          description: Service Unavailable
      x-badges:
      - name: FREE TIER
        position: before
        color: "#ccc"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /industry/faa-ladd/{id}/status:
    get:
      tags:
      - Industry API
      summary: AeroDataBox FAA LADD Aircraft Status / TIER 3
      description: "*Returns:* The **current** status of the specified aircraft in the Limiting Aircraft Displayed program\r\nof the Federal Aviation Administration of the U.S. Department of Transportation
        (FAA LADD). \r\nThe industry list of blocked aircraft is synchrornized weekly with the FAA. \r\nMore information about FAA LADD: https://www.faa.gov/pilots/ladd\r\n\r\n**DISCLAIMER.** This endpoint
        is designed to provide easy access to verification against the FAA LADD industry list.\r\nEven though it is based on the official data distributed weekly by the FAA, this is **NOT the official source\r\
        \nof the FAA LADD data**. For the official sources, always contact the FAA directly."
      operationId: GetFaaLaddAircraftStatus
      parameters:
      - name: id
        in: path
        description: Callsign or aircraft tail number
        required: true
        schema:
          maxLength: 15
          minLength: 2
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FaaLaddAircraftStatusContract"
              examples:
                GetFaaLaddAircraftStatus200Example:
                  summary: Default GetFaaLaddAircraftStatus 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    isBlocked: true
                    blockedSince: '2025-03-15T14:30:00Z'
                    lastBlockedOn: '2025-03-15T14:30:00Z'
            application/xml:
              schema:
                $ref: "#/components/schemas/FaaLaddAircraftStatusContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFaaLaddAircraftStatus400Example:
                  summary: Default GetFaaLaddAircraftStatus 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:
                GetFaaLaddAircraftStatus401Example:
                  summary: Default GetFaaLaddAircraftStatus 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:
                GetFaaLaddAircraftStatus451Example:
                  summary: Default GetFaaLaddAircraftStatus 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:
                GetFaaLaddAircraftStatus500Example:
                  summary: Default GetFaaLaddAircraftStatus 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
    parameters:
    - *a1
  /airports/{codeType}/{code}/time/local:
    get:
      tags:
      - Miscellaneous API
      summary: AeroDataBox Current Local Time at the Airport / TIER 1
      description: "**What is the current local time at the airport?**\r\n\r\nAt the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns:* Local time at the airport,
        if airport is found."
      operationId: GetAirportLocalTime
      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/AirportLocalTimeContract"
              examples:
                GetAirportLocalTime200Example:
                  summary: Default GetAirportLocalTime 200 response
                  x-microcks-default: true
                  value:
                    time: example_value
                    timeZoneId: abc123
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportLocalTimeContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportLocalTime400Example:
                  summary: Default GetAirportLocalTime 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:
                GetAirportLocalTime401Example:
                  summary: Default GetAirportLocalTime 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:
                GetAirportLocalTime451Example:
                  summary: Default GetAirportLocalTime 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:
                GetAirportLocalTime500Example:
                  summary: Default GetAirportLocalTime 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{code}/time/solar:
    get:
      tags:
      - Miscellaneous API
      summary: AeroDataBox Solar and Day Time at the Airport / TIER 1
      description: "**What is the sun position in the sky now at a specific time at the airport?** or\r\n**When does the sun rise and set at the airport today or on the other day at the airport?** or\r\n\
        **Is it dark now or is it day at the airport?**\r\n\r\nAt the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns:* If airport is found, returns various
        solar-related information: sun position in the sky,\r\ndaytime (day, night, twilight: civil, nautical, astronomical, golden/blue hours), \r\nsunrise and sunset times, etc."
      operationId: GetAirportSolarTime_SolarTimeCurrent
      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/SolarStateContract"
              examples:
                GetAirportSolarTime_SolarTimeCurrent200Example:
                  summary: Default GetAirportSolarTime_SolarTimeCurrent 200 response
                  x-microcks-default: true
                  value:
                    location: example_value
                    sunElevation: example_value
                    sunAzimuth: example_value
                    dayTime:
                    - example_value
                    dawnAstronomical: example_value
                    dawnNautical: example_value
                    dawnCivil: example_value
                    sunrise: example_value
                    noonTrue: example_value
                    sunset: example_value
                    duskCivil: example_value
                    duskNautical: example_value
                    duskAstronomical: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/SolarStateContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportSolarTime_SolarTimeCurrent400Example:
                  summary: Default GetAirportSolarTime_SolarTimeCurrent 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:
                GetAirportSolarTime_SolarTimeCurrent401Example:
                  summary: Default GetAirportSolarTime_SolarTimeCurrent 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:
                GetAirportSolarTime_SolarTimeCurrent451Example:
                  summary: Default GetAirportSolarTime_SolarTimeCurrent 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:
                GetAirportSolarTime_SolarTimeCurrent500Example:
                  summary: Default GetAirportSolarTime_SolarTimeCurrent 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{code}/time/solar/{dateLocal}:
    get:
      tags:
      - Miscellaneous API
      summary: AeroDataBox Solar and Day Time at the Airport / TIER 1
      description: "**What is the sun position in the sky now at a specific time at the airport?** or\r\n**When does the sun rise and set at the airport today or on the other day at the airport?** or\r\n\
        **Is it dark now or is it day at the airport?**\r\n\r\nAt the moment airports having both ICAO and IATA code are present in database only.\r\n\r\n*Returns:* If airport is found, returns various
        solar-related information: sun position in the sky,\r\ndaytime (day, night, twilight: civil, nautical, astronomical, golden/blue hours), \r\nsunrise and sunset times, etc."
      operationId: GetAirportSolarTime_SolarTimeSpecificDate
      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 which solar data is request for (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/SolarStateContract"
              examples:
                GetAirportSolarTime_SolarTimeSpecificDate200Example:
                  summary: Default GetAirportSolarTime_SolarTimeSpecificDate 200 response
                  x-microcks-default: true
                  value:
                    location: example_value
                    sunElevation: example_value
                    sunAzimuth: example_value
                    dayTime:
                    - example_value
                    dawnAstronomical: example_value
                    dawnNautical: example_value
                    dawnCivil: example_value
                    sunrise: example_value
                    noonTrue: example_value
                    sunset: example_value
                    duskCivil: example_value
                    duskNautical: example_value
                    duskAstronomical: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/SolarStateContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportSolarTime_SolarTimeSpecificDate400Example:
                  summary: Default GetAirportSolarTime_SolarTimeSpecificDate 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:
                GetAirportSolarTime_SolarTimeSpecificDate401Example:
                  summary: Default GetAirportSolarTime_SolarTimeSpecificDate 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:
                GetAirportSolarTime_SolarTimeSpecificDate451Example:
                  summary: Default GetAirportSolarTime_SolarTimeSpecificDate 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:
                GetAirportSolarTime_SolarTimeSpecificDate500Example:
                  summary: Default GetAirportSolarTime_SolarTimeSpecificDate 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 1
        position: before
        color: "#beffe6"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{codeFrom}/distance-time/{codeTo}:
    get:
      tags:
      - Miscellaneous API
      summary: AeroDataBox Distance and Flight Time Between Airports / TIER 2
      description: "**What is the great circle distance between airports?** \r\n**What is approximate flight time between airports?**\r\n** What is the flight time between airports based on history of flights
        and/or aircraft type?** (machine-learning based)\r\n\r\nUse `flightTimeModel` = <a href=\"#model-ModelFlightTimeEnum\">ML01</a> to get more accurate results based on historical performance of flights
        on a specific route \r\nand aircraft type.\r\n\r\n*Returns:* Distance and approximate flight time between airports, if both airports found."
      operationId: GetAirportDistanceTime
      parameters:
      - name: codeType
        in: path
        description: Type of code to search airport by (`iata` or `icao`)
        schema:
          $ref: "#/components/schemas/AirportCodesByEnum"
      - name: codeFrom
        in: path
        description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the origin airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character
          IATA-code of the origin  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: codeTo
        in: path
        description: "If `codeType` is:\r\n* `icao`, then this field must be a 4-character ICAO-code of the destination airport (e.g.: EHAM, KLAX, UUEE, etc.);\r\n* `iata`, then this field must be a 3-character
          IATA-code of the destination  airport (e.g.: AMS, SFO, LAX, etc.);\r\n* `local`, then the format of this field is subject to specific standards of relevant national or local airport codification
          systems.\r\n\r\nFull, stripped and any case formats are acceptable."
        required: true
        schema:
          maxLength: 4
          minLength: 3
          type: string
      - name: aircraftName
        in: query
        description: "Aircraft type name (free text). \r\nIf specified, the aircraft type will be attempted to be taken into account to provide more accurate result."
        schema:
          type: string
      - name: flightTimeModel
        in: query
        description: "Model of calculation of the flight time. Default is <a href=\"#model-ModelFlightTimeEnum\"></a>\r\nMore advanced model(s) is available, including machine learning-based models.\r\n\
          See <a href=\"#model-ModelFlightTimeEnum\">ModelFlightTimeEnum</a> for details."
        schema:
          $ref: "#/components/schemas/ModelFlightTimeEnum"
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AirportDistanceTimeContract"
              examples:
                GetAirportDistanceTime200Example:
                  summary: Default GetAirportDistanceTime 200 response
                  x-microcks-default: true
                  value:
                    from: example_value
                    to: example_value
                    greatCircleDistance: example_value
                    approxFlightTime: example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/AirportDistanceTimeContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetAirportDistanceTime400Example:
                  summary: Default GetAirportDistanceTime 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:
                GetAirportDistanceTime401Example:
                  summary: Default GetAirportDistanceTime 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:
                GetAirportDistanceTime451Example:
                  summary: Default GetAirportDistanceTime 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:
                GetAirportDistanceTime500Example:
                  summary: Default GetAirportDistanceTime 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 2
        position: before
        color: "#aab6f8"
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - *a1
  /airports/{codeType}/{code}/delays:
    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
    parameters:
    - *a1
  /airports/{codeType}/{code}/delays/{dateLocal}:
    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
    parameters:
    - *a1
  /airports/{codeType}/{code}/delays/{dateFromLocal}/{dateToLocal}:
    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
    parameters:
    - *a1
  /airports/{codeType}/{code}/stats/routes/daily:
    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
    parameters:
    - *a1
  /airports/{codeType}/{code}/stats/routes/daily/{dateLocal}:
    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
    parameters:
    - *a1
  /airports/delays:
    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
    parameters:
    - *a1
  /airports/delays/{dateUtc}:
    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_GlobalDelaysAtSpecificDate
      parameters:
      - name: dateUtc
        in: path
        description: "The moment of time for / from which delay data is requested (UTC 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:
                GetGlobalDelays_GlobalDelaysAtSpecificDate200Example:
                  summary: Default GetGlobalDelays_GlobalDelaysAtSpecificDate 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_GlobalDelaysAtSpecificDate400Example:
                  summary: Default GetGlobalDelays_GlobalDelaysAtSpecificDate 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_GlobalDelaysAtSpecificDate401Example:
                  summary: Default GetGlobalDelays_GlobalDelaysAtSpecificDate 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_GlobalDelaysAtSpecificDate451Example:
                  summary: Default GetGlobalDelays_GlobalDelaysAtSpecificDate 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_GlobalDelaysAtSpecificDate500Example:
                  summary: Default GetGlobalDelays_GlobalDelaysAtSpecificDate 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
    parameters:
    - *a1
  /flights/{number}/delays:
    get:
      tags:
      - Statistical API
      summary: AeroDataBox Flight Delay Statistics by Flight Number / TIER 3
      description: "**By how much the flight is delayed in average?**\r\n\r\nInformation is only available for flights which were tracked with live updates at least at origin or at destination within the
        last 90 days.\r\n\r\n*Returns:* delay statistics for the flight with specified number."
      operationId: GetFlightDelays
      parameters:
      - name: number
        in: path
        description: Flight number (with or without spaces, IATA or ICAO, any case formats are acceptable, e.g. KL1395, Klm 1395)
        required: true
        schema:
          maxLength: 8
          type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FlightLegDelayContract"
              examples:
                GetFlightDelays200Example:
                  summary: Default GetFlightDelays 200 response
                  x-microcks-default: true
                  value:
                    number: example_value
                    origins:
                    - example_value
                    destinations:
                    - example_value
            application/xml:
              schema:
                $ref: "#/components/schemas/FlightLegDelayContract"
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorContract"
              examples:
                GetFlightDelays400Example:
                  summary: Default GetFlightDelays 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:
                GetFlightDelays401Example:
                  summary: Default GetFlightDelays 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:
                GetFlightDelays451Example:
                  summary: Default GetFlightDelays 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:
                GetFlightDelays500Example:
                  summary: Default GetFlightDelays 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
    parameters:
    - *a1
components:
  schemas:
    AircraftContract:
      required:
      - active
      - id
      - isFreighter
      - numRegistrations
      - reg
      - verified
      type: object
      properties:
        id:
          type: integer
          description: Unique ID of the aircraft record in our database
          format: int64
        reg:
          minLength: 1
          type: string
          description: Tail-number of the aircraft
        active:
          type: boolean
          description: Indicator if aircraft is operational under this registration
        serial:
          type: string
          description: Serial number
          nullable: true
        hexIcao:
          type: string
          description: ICAO 24 bit Mode-S hexadecimal transponder address
          nullable: true
        airlineName:
          type: string
          description: Name of the airline operating the aircraft
          nullable: true
        iataType:
          type: string
          description: IATA-type of the aircraft
          nullable: true
        iataCodeShort:
          type: string
          description: Short variant of IATA-code of the aircraft
          nullable: true
        icaoCode:
          type: string
          description: ICAO-code of the aircraft
          nullable: true
        model:
          type: string
          description: Model of the aircraft
          nullable: true
        modelCode:
          type: string
          description: Model code of the aircraft
          nullable: true
        numSeats:
          type: integer
          description: Number of passenger seats
          format: int32
          nullable: true
        rolloutDate:
          type: string
          description: Date of roll-out (UTC)
          format: date-time
          nullable: true
        firstFlightDate:
          type: string
          description: First flight date
          format: date-time
          nullable: true
        deliveryDate:
          type: string
          description: Date of delivery to the owner
          format: date-time
          nullable: true
        registrationDate:
          type: string
          description: Date of assigning current registration
          format: date-time
          nullable: true
        typeName:
          type: string
          description: Type name
          nullable: true
        numEngines:
          type: integer
          description: Number of engines
          format: int32
          nullable: true
        engineType:
          $ref: "#/components/schemas/EngineType"
        isFreighter:
          type: boolean
          description: Marker if aircraft is cargo or not
        productionLine:
          type: string
          description: Production line
          nullable: true
        ageYears:
          type: number
          description: Age of the aircraft in year
          format: float
          nullable: true
        verified:
          type: boolean
        image:
          $ref: "#/components/schemas/ResourceContract"
        numRegistrations:
          type: integer
          description: "An aircraft may have a history of past registrations with other airlines or operators.\r\nThis field represents a total number of registration records known in our database."
          format: int32
        registrations:
          type: array
          items:
            $ref: "#/components/schemas/AircraftRegistrationContract"
          description: A history of all registrations with other airlines or operators (if provided by the endpoint).
          nullable: true
      additionalProperties: false
      description: Single aircraft data
    AircraftContractPagedCollectionContract:
      required:
      - count
      - hasNextPage
      - items
      - pageOffset
      - pageSize
      - totalCount
      type: object
      properties:
        totalCount:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The total number of items across all pages
          format: int32
        pageOffset:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: "The offset of the current page of the collection \r\n(number of items skipped before this page)"
          format: int32
        pageSize:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: "Maximum number of items on the current page of the collection\r\n(`Count` cannot be more than this value)"
          format: int32
        hasNextPage:
          type: boolean
          description: This value is true when collection has more pages
          readOnly: true
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            $ref: "#/components/schemas/AircraftContract"
          description: The collection of items
      additionalProperties: false
    AircraftRegistrationContract:
      required:
      - active
      - reg
      type: object
      properties:
        reg:
          minLength: 1
          type: string
          description: Tail-number of the aircraft
        active:
          type: boolean
          description: Indicator if aircraft is operational under this registration
        hexIcao:
          type: string
          description: ICAO 24 bit Mode-S hexadecimal transponder address
          nullable: true
        airlineName:
          type: string
          description: Name of the airline operating the aircraft
          nullable: true
        registrationDate:
          type: string
          description: Date of assigning current registration
          format: date-time
          nullable: true
      additionalProperties: false
      description: Aircraft registration data
    AircraftSearchByEnum:
      enum:
      - Id
      - Reg
      - Icao24
      type: string
      description: "Criteria to search aircraft by<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Id</b>: ID of the aircraft (as stored in this API)</li>\r\n<li><b>1 - Reg</b>: Search by aircraft tail-number</li>\r\
        \n<li><b>2 - Icao24</b>: Search by 24-bit ICAO Mode-S Transponder code</li>\r\n</ul>\r\n"
    AirportCodesByEnum:
      enum:
      - Icao
      - Iata
      type: string
      description: "Search by airport code type<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Icao</b>: ICAO-code</li>\r\n<li><b>1 - Iata</b>: IATA-code</li>\r\n</ul>\r\n"
    AirportContract:
      required:
      - continent
      - country
      - elevation
      - fullName
      - location
      - timeZone
      - urls
      type: object
      properties:
        icao:
          type: string
          description: ICAO code of the airport
          nullable: true
        iata:
          type: string
          description: IATA code of the airport
          nullable: true
        localCode:
          type: string
          description: Code of the airport within the local or national coding system
          nullable: true
        shortName:
          type: string
          description: Shortened name of the airport
          nullable: true
        fullName:
          minLength: 1
          type: string
          description: Full name of the airport (derived from own airport name and municipality name)
        municipalityName:
          type: string
          description: Name of the municipality this airport belongs to
          nullable: true
        location:
          $ref: "#/components/schemas/GeoCoordinatesContract"
        elevation:
          $ref: "#/components/schemas/Distance"
        country:
          $ref: "#/components/schemas/CountryContract"
        continent:
          $ref: "#/components/schemas/ContinentContract"
        timeZone:
          minLength: 1
          type: string
          description: Time zone of the airport in Olson format (e.g. "Europe/Amsterdam")
        urls:
          $ref: "#/components/schemas/AirportUrlsContract"
        runways:
          type: array
          items:
            $ref: "#/components/schemas/RunwayContract"
          description: List of runway information, if requested
          nullable: true
        currentTime:
          $ref: "#/components/schemas/AirportLocalTimeContract"
      additionalProperties: false
      description: Single airport data
    AirportDelayContract:
      required:
      - airportIcao
      - arrivalsDelayInformation
      - departuresDelayInformation
      - from
      - to
      type: object
      properties:
        airportIcao:
          minLength: 1
          type: string
          description: Airport ICAO code
        from:
          $ref: "#/components/schemas/DateTimeContract"
        to:
          $ref: "#/components/schemas/DateTimeContract"
        departuresDelayInformation:
          $ref: "#/components/schemas/FlightBatchDelayContract"
        arrivalsDelayInformation:
          $ref: "#/components/schemas/FlightBatchDelayContract"
      additionalProperties: false
    AirportDistanceTimeContract:
      required:
      - approxFlightTime
      - from
      - greatCircleDistance
      - to
      type: object
      properties:
        from:
          $ref: "#/components/schemas/ListingAirportContract"
        to:
          $ref: "#/components/schemas/ListingAirportContract"
        greatCircleDistance:
          $ref: "#/components/schemas/Distance"
        approxFlightTime:
          type: string
          description: "Approximate flight time based on re-calculation of great circle distance\r\nagainst statistical duration average of multiple flights covered similar\r\ndistance before."
          format: date-span
      additionalProperties: false
      description: "Contract containing information on distance and approximate flight time\r\nbetween specified airports"
    AirportFeedServiceStatusContract:
      required:
      - adsbUpdatesFeed
      - flightSchedulesFeed
      - generalAvailability
      - liveFlightUpdatesFeed
      type: object
      properties:
        flightSchedulesFeed:
          $ref: "#/components/schemas/FeedServiceStatusContract"
        liveFlightUpdatesFeed:
          $ref: "#/components/schemas/FeedServiceStatusContract"
        adsbUpdatesFeed:
          $ref: "#/components/schemas/FeedServiceStatusContract"
        generalAvailability:
          $ref: "#/components/schemas/FlightDataGeneralAvailabilityContract"
      additionalProperties: false
      description: "Airport data feed services status.\r\nRead https://aerodatabox.com/data-coverage for context."
    AirportFidsContract:
      type: object
      properties:
        departures:
          type: array
          items:
            $ref: "#/components/schemas/AirportFlightContract"
          description: Departing flights
          nullable: true
        arrivals:
          type: array
          items:
            $ref: "#/components/schemas/AirportFlightContract"
          description: Arriving flights
          nullable: true
      additionalProperties: false
      description: Airport schedule contract
    AirportFlightContract:
      required:
      - codeshareStatus
      - isCargo
      - number
      - status
      type: object
      properties:
        movement:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        departure:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        arrival:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        number:
          minLength: 1
          type: string
          description: Flight Number
        callSign:
          type: string
          description: ATC call-sign of the flight
          nullable: true
        status:
          $ref: "#/components/schemas/FlightStatus"
        codeshareStatus:
          $ref: "#/components/schemas/CodeshareStatus"
        isCargo:
          type: boolean
          description: Is cargo flight
        aircraft:
          $ref: "#/components/schemas/FlightAircraftContract"
        airline:
          $ref: "#/components/schemas/FlightAirlineContract"
        location:
          $ref: "#/components/schemas/FlightLocationContract"
      additionalProperties: false
      description: Flight data contract represented in airport schedule
    AirportLocalTimeContract:
      required:
      - time
      - timeZoneId
      type: object
      properties:
        time:
          $ref: "#/components/schemas/DateTimeContract"
        timeZoneId:
          minLength: 1
          type: string
          description: Timezone ID of the airport (Olson format)
      additionalProperties: false
      description: Information about the local time at an airport
    AirportUrlsContract:
      type: object
      properties:
        webSite:
          type: string
          description: Main web-site of the airport
          nullable: true
        wikipedia:
          type: string
          description: Wikipedia page of the airport
          nullable: true
        twitter:
          type: string
          description: Twitter feed of the airport
          nullable: true
        liveAtc:
          type: string
          description: LiveAtc page of the airport
          nullable: true
        flightRadar:
          type: string
          description: FlightRadar page of the airport
          nullable: true
        googleMaps:
          type: string
          description: Google Maps URL of the airport
          nullable: true
      additionalProperties: false
      description: Airport URLs contract
    Angle:
      required:
      - deg
      - rad
      type: object
      properties:
        deg:
          maximum: 180
          minimum: -180
          type: number
          description: Angle in degrees (between `-180` and `180`)
          format: double
        rad:
          maximum: 3.141592653589793
          minimum: -3.141592653589793
          type: number
          description: Angle in radians (between `-Pi` and `Pi`)
          format: double
      additionalProperties: false
    Azimuth:
      required:
      - deg
      - rad
      type: object
      properties:
        deg:
          maximum: 360
          minimum: 0
          type: number
          description: Angle in degrees (between `0` and `360`)
          format: double
        rad:
          maximum: 6.283185307179586
          minimum: 0
          type: number
          description: Angle in radians (`0` and `2 * Pi`)
          format: double
      additionalProperties: false
    CodeshareStatus:
      enum:
      - Unknown
      - IsOperator
      - IsCodeshared
      type: string
      description: "Flight code-share status<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Unknown</b>: Code-sharing information is unavailable for this flight. Flight might be operated both by airline owning
        the flight number as well as by another airliner.</li>\r\n<li><b>1 - IsOperator</b>: Flight is operated by an airline owning the flight number (the same code)</li>\r\n<li><b>2 - IsCodeshared</b>:
        Flight is code-shared (operated by an airline other than airline owning the flight number)</li>\r\n</ul>\r\n"
    ContinentContract:
      required:
      - code
      type: object
      properties:
        code:
          minLength: 1
          type: string
          description: Code
        name:
          type: string
          description: Name
          nullable: true
      additionalProperties: false
      description: Continent data
    CountryContract:
      required:
      - code
      type: object
      properties:
        code:
          minLength: 1
          type: string
          description: Code
        name:
          type: string
          description: Name
          nullable: true
      additionalProperties: false
      description: Country data
    CreateWebHookSubscription:
      required:
      - url
      type: object
      properties:
        url:
          minLength: 1
          type: string
          description: "Destination HTTP-endpoint where notifications will be sent to. Requirements:\r\n* must be a valid public HTTP(S) URL not requiring additional authorization;\r\n* must use standard
            or alternative HTTP or HTTPS ports (80, 443, 8008, 8080) or any dynamic port greater or equal to 49152;\r\n* must be able to accept HTTP POST request with JSON-formatted body (application/json);\r\
            \n* must respond with one of successful HTTP status codes (2XX) within 10 seconds;\r\n* the endpoint owner must be aware of and consent to receiving notifications at it.\r\n\r\nIf endpoint is
            unavailable, responds with error status code or does not respond within timeout,\r\nnotification delivery retry may be attempted according to subscription settings."
        maxDeliveryRetries:
          maximum: 2
          minimum: 0
          type: integer
          description: "Maximum number of times a delivery attempt is retried after initial delivery attempt failure.\r\n\r\nCurrent default value is:\r\n\r\n\t* `2` for the old, lifetime-based web-hook
            subscriptions (will be phased out after the 4th of April, 2026);\r\n\t* `0` for the new, credit-based web-hook subscriptions (will be the default value for any web-hook subscription after the
            4th of April, 2026)."
          format: int32
          nullable: true
      additionalProperties: false
      description: Command to create web-hook subscription
    DailyRouteStatContract:
      required:
      - routes
      type: object
      properties:
        routes:
          type: array
          items:
            $ref: "#/components/schemas/DailyRouteStatRecordContract"
      additionalProperties: false
      description: Route daily statistics of the airport
    DailyRouteStatRecordContract:
      required:
      - averageDailyFlights
      - destination
      - operators
      type: object
      properties:
        destination:
          $ref: "#/components/schemas/ListingAirportContract"
        averageDailyFlights:
          type: number
          description: Daily average of flights per destination
          format: float
        operators:
          type: array
          items:
            $ref: "#/components/schemas/FlightAirlineContract"
          description: Airlines operating on the route
      additionalProperties: false
      description: Statistical record of route daily statistics
    DateTimeContract:
      required:
      - local
      - utc
      type: object
      properties:
        utc:
          type: string
          description: UTC-time
          format: date-time
        local:
          type: string
          description: Local time
          format: date-time
      additionalProperties: false
      description: Descriptor date-time represented in both UTC and local timezones
    DayTime:
      enum:
      - Night
      - TwilightAstronomical
      - TwilightNautical
      - TwilightCivil
      - Day
      - BlueHour
      - GoldenHour
      type: string
      description: "Daytime states<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Night</b></li>\r\n<li><b>1 - TwilightAstronomical</b></li>\r\n<li><b>2 - TwilightNautical</b></li>\r\n<li><b>3 - TwilightCivil</b></li>\r\
        \n<li><b>4 - Day</b></li>\r\n<li><b>5 - BlueHour</b></li>\r\n<li><b>6 - GoldenHour</b></li>\r\n</ul>\r\n"
    DelayBracketContract:
      required:
      - num
      type: object
      properties:
        delayedFrom:
          type: string
          description: "The beginning of the delay range (format: [-]hh:mm:ss).\r\nE.g. in the expresssion \"delayed from 30 to 60 minutes\" stands for \"from 30 minutes\".\r\nValue can be negative (therefore,
            means early occurence).\r\n\r\nMust be preset if \"DelayedTo\" is not specified."
          format: date-span
          nullable: true
        delayedTo:
          type: string
          description: "The end of the delay range (format: [-]hh:mm:ss).\r\nE.g. in the expresssion \"delayed from 30 to 60 minutes\" stands for \"to 60 minutes\".\r\nValue can be negative (therefore,
            means early occurence).\r\n\r\nMust be preset if \"DelayedFrom\" is not specified."
          format: date-span
          nullable: true
        num:
          type: integer
          description: Count of records subject to a specified delay range
          format: int32
        percentage:
          type: number
          description: "Percentage of records subject to a specified delay range.\r\n\r\nOnly available when this delay bracket is provided as a part\r\nof a statistical information of a bigger context
            and the \"total\"\r\ncount of records is known."
          format: float
          nullable: true
      additionalProperties: false
      description: Delay bracket contract describing how many records are subject to a specific delay range
    Distance:
      required:
      - feet
      - km
      - meter
      - mile
      - nm
      type: object
      properties:
        meter:
          type: number
          description: Distance in meters
          format: double
        km:
          type: number
          description: Distance in kilometers
          format: double
        mile:
          type: number
          description: Distance in statute miles
          format: double
        nm:
          type: number
          description: Distance in nautical miles
          format: double
        feet:
          type: number
          description: Distance in feet
          format: double
      additionalProperties: false
    DistanceFlightPlanUnitContract:
      type: object
      properties:
        requested:
          $ref: "#/components/schemas/Distance"
        assigned:
          $ref: "#/components/schemas/Distance"
      additionalProperties: false
      description: "Contract describing unit (altitude, airspeed, etc.) which can be assigned and / or requested\r\nin the context of the flight plan"
    EngineType:
      enum:
      - Unknown
      - Jet
      - Turboprop
      - Piston
      type: string
      description: "<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Unknown</b></li>\r\n<li><b>1 - Jet</b></li>\r\n<li><b>2 - Turboprop</b></li>\r\n<li><b>3 - Piston</b></li>\r\n</ul>\r\n"
    ErrorContract:
      required:
      - message
      type: object
      properties:
        message:
          minLength: 1
          type: string
          description: Error message
      additionalProperties: false
      description: Error response
    FaaLaddAircraftStatusContract:
      required:
      - id
      - isBlocked
      type: object
      properties:
        id:
          type: string
          format: string
        isBlocked:
          type: boolean
          description: Current status of the aircraft / flight in the FAA LADD industry list.
        blockedSince:
          type: string
          description: "For blocked aircraft only: the date when the aircraft / flight was blocked.\r\nWill not be included for blocked dates at or prior to September 15, 2024."
          format: date-time
          nullable: true
        lastBlockedOn:
          type: string
          description: "For unblocked aircraft only: the date when the aircraft / flight was last blocked.\r\nWill not be included for blocked dates at or prior to September 15, 2024 or \r\nfor the aircraft
            that were never blocked."
          format: date-time
          nullable: true
      additionalProperties: false
      description: "Status of the aircraft tail number or callsign in the FAA Limiting Aircraft Data Displayed (LADD) Program list.\r\nSee https://www.faa.gov/pilots/ladd for more details."
    FeedServiceEnum:
      enum:
      - FlightSchedules
      - FlightLiveUpdates
      - AdsbUpdates
      type: string
      description: "Airport feed service defininitions<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - FlightSchedules</b>: Flight schedules data feed for this airport (static schedules data without actual
        updates)</li>\r\n<li><b>1 - FlightLiveUpdates</b>: Actual flight status and time updates for this airport</li>\r\n<li><b>2 - AdsbUpdates</b>: Flight updates derived from ADS-B data for this airport:
        runway, actual/estimated time on the runway, call-sign, ModeS 24-bit ICAO code, aircraft registration</li>\r\n</ul>\r\n"
    FeedServiceStatus:
      enum:
      - Down
      - Degraded
      - OKPartial
      - OK
      - Unknown
      - Unavailable
      type: string
      description: "Descriptor of feed service status<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Down</b>: Service is provided, but is currently down</li>\r\n<li><b>1 - Degraded</b>: Service is up and
        running, but performance is degraded: delays and disruptions are likely</li>\r\n<li><b>2 - OKPartial</b>: Service is up and running normally, but updates vailable for not all or only few flights</li>\r\
        \n<li><b>3 - OK</b>: Service is up and running normally</li>\r\n<li><b>-2 - Unknown</b>: Status of service is unknown</li>\r\n<li><b>-1 - Unavailable</b>: Service is not provided</li>\r\n</ul>\r\
        \n"
    FeedServiceStatusContract:
      required:
      - service
      - status
      type: object
      properties:
        service:
          $ref: "#/components/schemas/FeedServiceEnum"
        status:
          $ref: "#/components/schemas/FeedServiceStatus"
        minAvailableLocalDate:
          type: string
          description: Date of the oldest flight stored (based on scheduled local times)
          format: date-time
          nullable: true
          deprecated: true
        maxAvailableLocalDate:
          type: string
          description: Date of the most recent flight stored (based on scheduled local times)
          format: date-time
          nullable: true
          deprecated: true
      additionalProperties: false
      description: "Feed service status contract.\r\nRead https://aerodatabox.com/data-coverage for context."
    FlightAircraftContract:
      type: object
      properties:
        reg:
          type: string
          description: Tail-number of the aircraft
          nullable: true
        modeS:
          type: string
          description: ICAO 24 bit Mode-S hexadecimal transponder address
          nullable: true
        model:
          type: string
          description: Aircraft name and model
          nullable: true
        image:
          $ref: "#/components/schemas/ResourceContract"
      additionalProperties: false
      description: Flight's aircraft reference contract
    FlightAirlineContract:
      required:
      - name
      type: object
      properties:
        name:
          minLength: 1
          type: string
          description: Airline name
        iata:
          type: string
          description: IATA code of the airline
          nullable: true
        icao:
          type: string
          description: ICAO code of the airline
          nullable: true
      additionalProperties: false
      description: Flight's airline reference conract
    FlightAirportMovementContract:
      required:
      - airport
      - quality
      type: object
      properties:
        airport:
          $ref: "#/components/schemas/ListingAirportContract"
        scheduledTime:
          $ref: "#/components/schemas/DateTimeContract"
        revisedTime:
          $ref: "#/components/schemas/DateTimeContract"
        predictedTime:
          $ref: "#/components/schemas/DateTimeContract"
        runwayTime:
          $ref: "#/components/schemas/DateTimeContract"
        terminal:
          type: string
          description: Terminal of the flight
          nullable: true
        checkInDesk:
          type: string
          description: Check-in desk(s) for the flight (only for departing flights)
          nullable: true
        gate:
          type: string
          description: Gate of (un)boarding for the flight
          nullable: true
        baggageBelt:
          type: string
          description: Baggage belt(s) for the flight (only for arriving flights)
          nullable: true
        runway:
          type: string
          description: Name of a runway of landing (for arriving flights) or take-off (for departing flights), if known.
          nullable: true
        quality:
          type: array
          items:
            $ref: "#/components/schemas/FlightAirportMovementQualityEnum"
          description: "Array of quality characteristics of the data. Check this to know which information\r\nyou can expect within this contract (basic, live and/or approximate data)."
      additionalProperties: false
      description: Flight arrival or departure information
    FlightAirportMovementQualityEnum:
      enum:
      - Basic
      - Live
      - Approximate
      type: string
      description: "Quality characteristics of the information provided within flight FlightAirportMovementContract<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Basic</b></li>\r\n<li><b>1 - Live</b></li>\r\
        \n<li><b>2 - Approximate</b></li>\r\n</ul>\r\n"
    FlightBatchDelayContract:
      required:
      - numCancelled
      - numQualifiedTotal
      - numTotal
      type: object
      properties:
        numTotal:
          type: integer
          description: Total number of flights in the the batch (including cancelled)
          format: int32
        numQualifiedTotal:
          type: integer
          description: "Total number of flights in the batch, which were used to to calculate the\r\ndelay information (including cancelled). Should equal to or less than `NumTotal`.\r\n\r\nThe closer the
            value of this property to the value of `NumTotal`, the higher the\r\nreliability of delay information"
          format: int32
        numCancelled:
          type: integer
          description: Total amount of flights in the batch
          format: int32
        medianDelay:
          type: string
          description: "Median delay of flights in the batch (format: [-]hh:mm:ss).\r\nValue can be negative (therefore, means early occurence)."
          format: date-span
          nullable: true
        delayIndex:
          type: number
          description: Normalized value on scale from 0.0 to 5.0 which corresponds with current amount of delays and cancellations in a given batch of flights (the less - the better).
          format: float
          nullable: true
      additionalProperties: false
      description: Delay information about a batch of flights
    FlightContract:
      required:
      - arrival
      - codeshareStatus
      - departure
      - isCargo
      - lastUpdatedUtc
      - number
      - status
      type: object
      properties:
        greatCircleDistance:
          $ref: "#/components/schemas/Distance"
        departure:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        arrival:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        flightPlan:
          $ref: "#/components/schemas/FlightPlanContract"
        lastUpdatedUtc:
          type: string
          description: Time (UTC) of the latest update of flight information (excluding Location)
          format: date-time
        number:
          minLength: 1
          type: string
          description: Flight Number
        callSign:
          type: string
          description: ATC call-sign of the flight
          nullable: true
        status:
          $ref: "#/components/schemas/FlightStatus"
        codeshareStatus:
          $ref: "#/components/schemas/CodeshareStatus"
        isCargo:
          type: boolean
          description: Is cargo flight
        aircraft:
          $ref: "#/components/schemas/FlightAircraftContract"
        airline:
          $ref: "#/components/schemas/FlightAirlineContract"
        location:
          $ref: "#/components/schemas/FlightLocationContract"
      additionalProperties: false
      description: Individiual flight contract
    FlightDataGeneralAvailabilityContract:
      type: object
      properties:
        minAvailableLocalDate:
          type: string
          description: "Date of the oldest flight stored (based on scheduled local times)\r\nIf not specified, no flight data available"
          format: date-time
          nullable: true
        maxAvailableLocalDate:
          type: string
          description: "Date of the most recent flight stored (based on scheduled local times)\r\nIf not specified, no flight data available"
          format: date-time
          nullable: true
      additionalProperties: false
    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
    FlightDirection:
      enum:
      - Arrival
      - Departure
      - Both
      type: string
      description: "Direction of flight<p>Possible values:</p>\r\n<ul>\r\n<li><b>1 - Arrival</b></li>\r\n<li><b>2 - Departure</b></li>\r\n<li><b>3 - Both</b></li>\r\n</ul>\r\n"
    FlightLegDelayContract:
      required:
      - number
      type: object
      properties:
        number:
          minLength: 1
          type: string
          description: Flight number
        origins:
          type: array
          items:
            $ref: "#/components/schemas/FlightDelayContract"
          description: Delay statistics of flight on departure at origins
          nullable: true
        destinations:
          type: array
          items:
            $ref: "#/components/schemas/FlightDelayContract"
          description: Delay statistics of flight on arrival at destinations
          nullable: true
      additionalProperties: false
      description: Delay statistics of a flight leg
    FlightLocationContract:
      required:
      - altitude
      - groundSpeed
      - lat
      - lon
      - pressure
      - pressureAltitude
      - reportedAtUtc
      - trueTrack
      type: object
      properties:
        pressureAltitude:
          $ref: "#/components/schemas/Distance"
        altitude:
          $ref: "#/components/schemas/Distance"
        pressure:
          $ref: "#/components/schemas/Pressure"
        groundSpeed:
          $ref: "#/components/schemas/Speed"
        trueTrack:
          $ref: "#/components/schemas/Azimuth"
        vsiFpm:
          type: integer
          description: "Vertical speed, in feet per minute\r\nNot set if unknown or zero."
          format: int32
          nullable: true
        reportedAtUtc:
          type: string
          description: Time (UTC) of when this positional data was reported
          format: date-time
        lat:
          maximum: 90
          minimum: -90
          type: number
          description: Latitude, in degrees
          format: float
        lon:
          maximum: 180
          minimum: -180
          type: number
          description: Longitude, in degrees
          format: float
      additionalProperties: false
      description: "Positional information about flight: location, altitude, speed and track"
    FlightNotificationContract:
      required:
      - flights
      - subscription
      type: object
      properties:
        flights:
          type: array
          items:
            $ref: "#/components/schemas/FlightNotificationItemContract"
          description: Modified/created flight notification
        subscription:
          $ref: "#/components/schemas/SubscriptionContract"
        balance:
          $ref: "#/components/schemas/SubscriptionBalanceContract"
      additionalProperties: false
      description: Flight notification contract
    FlightNotificationItemContract:
      required:
      - arrival
      - codeshareStatus
      - departure
      - isCargo
      - lastUpdatedUtc
      - number
      - status
      type: object
      properties:
        notificationSummary:
          type: string
          description: Human-readable summary of the flight status update
          nullable: true
        notificationRemark:
          type: string
          description: Human-readable remark to the flight status update
          nullable: true
        greatCircleDistance:
          $ref: "#/components/schemas/Distance"
        departure:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        arrival:
          $ref: "#/components/schemas/FlightAirportMovementContract"
        flightPlan:
          $ref: "#/components/schemas/FlightPlanContract"
        lastUpdatedUtc:
          type: string
          description: Time (UTC) of the latest update of flight information (excluding Location)
          format: date-time
        number:
          minLength: 1
          type: string
          description: Flight Number
        callSign:
          type: string
          description: ATC call-sign of the flight
          nullable: true
        status:
          $ref: "#/components/schemas/FlightStatus"
        codeshareStatus:
          $ref: "#/components/schemas/CodeshareStatus"
        isCargo:
          type: boolean
          description: Is cargo flight
        aircraft:
          $ref: "#/components/schemas/FlightAircraftContract"
        airline:
          $ref: "#/components/schemas/FlightAirlineContract"
        location:
          $ref: "#/components/schemas/FlightLocationContract"
      additionalProperties: false
      description: Flight notification message contract
    FlightPlanContract:
      required:
      - lastUpdatedUtc
      - route
      type: object
      properties:
        flightRules:
          $ref: "#/components/schemas/FlightRules"
        flightType:
          $ref: "#/components/schemas/FlightType"
        revisionNo:
          type: integer
          description: No. of revision of the flight plan
          format: int32
          nullable: true
        status:
          $ref: "#/components/schemas/FlightPlanStatus"
        route:
          minLength: 1
          type: string
          description: Route information for the flight as filed in the flight plan
        altitude:
          $ref: "#/components/schemas/DistanceFlightPlanUnitContract"
        airspeed:
          $ref: "#/components/schemas/SpeedFlightPlanUnitContract"
        lastUpdatedUtc:
          type: string
          description: Time (UTC) of the latest known update to the flight plan
          format: date-time
      additionalProperties: false
      description: Flight plan contract
    FlightPlanStatus:
      enum:
      - Proposed
      - Active
      - Dropped
      - Cancelled
      - Completed
      type: string
    FlightRules:
      enum:
      - IFR
      - VFR
      type: string
    FlightSearchByEnum:
      enum:
      - Number
      - Reg
      - CallSign
      - Icao24
      type: string
      description: "Criteria to search flight by<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Number</b>: Search by flight number</li>\r\n<li><b>1 - Reg</b>: Search by aircraft registration</li>\r\n<li><b>2
        - CallSign</b>: Search by ATC call-sign</li>\r\n<li><b>3 - Icao24</b>: Search by 24-bit ICAO Mode-S Transponder code</li>\r\n</ul>\r\n"
    FlightSearchItemContract:
      required:
      - number
      type: object
      properties:
        number:
          minLength: 1
          type: string
          description: Found flight number.
      additionalProperties: false
      description: Flight record found in the search result.
    FlightStatus:
      enum:
      - Unknown
      - Expected
      - EnRoute
      - CheckIn
      - Boarding
      - GateClosed
      - Departed
      - Delayed
      - Approaching
      - Arrived
      - Canceled
      - Diverted
      - CanceledUncertain
      type: string
      description: "Flight progress status<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Unknown</b>: Status is not available for this flight</li>\r\n<li><b>1 - Expected</b>: Expected</li>\r\n<li><b>2 -
        EnRoute</b>: En route</li>\r\n<li><b>3 - CheckIn</b>: Check-in is open</li>\r\n<li><b>4 - Boarding</b>: Boarding in progress / Last call</li>\r\n<li><b>5 - GateClosed</b>: Gate closed</li>\r\n<li><b>6
        - Departed</b>: Departed</li>\r\n<li><b>7 - Delayed</b>: Delayed</li>\r\n<li><b>8 - Approaching</b>: On approach to destination</li>\r\n<li><b>9 - Arrived</b>: Arrived</li>\r\n<li><b>10 - Canceled</b>:
        Cancelled</li>\r\n<li><b>11 - Diverted</b>: Diverted to another destination</li>\r\n<li><b>12 - CanceledUncertain</b>: Status of the flight is uncertain, may be cancelled</li>\r\n</ul>\r\n"
    FlightType:
      enum:
      - Other
      - General
      - Scheduled
      - NonScheduled
      - Military
      type: string
    GeoCoordinatesContract:
      required:
      - lat
      - lon
      type: object
      properties:
        lat:
          maximum: 90
          minimum: -90
          type: number
          description: Latitude, in degrees
          format: float
        lon:
          maximum: 180
          minimum: -180
          type: number
          description: Longitude, in degrees
          format: float
      additionalProperties: false
      description: Geographical coordinates data
    GeoCoordinatesContractListingAirportContractSearchResultCollectionContract:
      required:
      - count
      - items
      - searchBy
      type: object
      properties:
        searchBy:
          $ref: "#/components/schemas/GeoCoordinatesContract"
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            $ref: "#/components/schemas/ListingAirportContract"
          description: The collection of items
      additionalProperties: false
    LicenseType:
      enum:
      - AllRightsReserved
      - AttributionNoncommercialShareAlikeCC
      - AttributionNoncommercialCC
      - AttributionNoncommercialNoDerivativesCC
      - AttributionCC
      - AttributionShareAlikeCC
      - AttributionNoDerivativesCC
      - NoKnownCopyrightRestrictions
      - UnitedStatesGovernmentWork
      - PublicDomainDedicationCC0
      - PublicDomainMark
      type: string
      description: "<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - AllRightsReserved</b>: All Rights Reserved.</li>\r\n<li><b>1 - AttributionNoncommercialShareAlikeCC</b>: Creative Commons: Attribution Non-Commercial,
        Share-alike License.</li>\r\n<li><b>2 - AttributionNoncommercialCC</b>: Creative Commons: Attribution Non-Commercial License.</li>\r\n<li><b>3 - AttributionNoncommercialNoDerivativesCC</b>: Creative
        Commons: Attribution Non-Commercial, No Derivatives License.</li>\r\n<li><b>4 - AttributionCC</b>: Creative Commons: Attribution License.</li>\r\n<li><b>5 - AttributionShareAlikeCC</b>: Creative
        Commons: Attribution Share-alike License.</li>\r\n<li><b>6 - AttributionNoDerivativesCC</b>: Creative Commons: Attribution No Derivatives License.</li>\r\n<li><b>7 - NoKnownCopyrightRestrictions</b>:
        No Known Copyright Resitrctions (Flickr Commons).</li>\r\n<li><b>8 - UnitedStatesGovernmentWork</b>: United States Government Work</li>\r\n<li><b>9 - PublicDomainDedicationCC0</b>: Public Domain
        Dedication, CC0</li>\r\n<li><b>10 - PublicDomainMark</b>: Public Domain Mark</li>\r\n</ul>\r\n"
    ListingAirportContract:
      required:
      - name
      type: object
      properties:
        icao:
          type: string
          description: ICAO code of the airport
          nullable: true
        iata:
          type: string
          description: IATA code of the airport
          nullable: true
        localCode:
          type: string
          description: Code of the airport within the local or national codification system
          nullable: true
        name:
          minLength: 1
          type: string
          description: Name of the airport
        shortName:
          type: string
          description: Shortened name of the airport
          nullable: true
        municipalityName:
          type: string
          description: Name of the municipality this airport belongs to
          nullable: true
        location:
          $ref: "#/components/schemas/GeoCoordinatesContract"
        countryCode:
          type: string
          description: Two-letter country code of the airport
          nullable: true
        timeZone:
          type: string
          description: Time zone of the airport in Olson format (e.g. "Europe/Amsterdam")
          nullable: true
      additionalProperties: false
      description: Flight's airport reference contract
    ModelFlightTimeEnum:
      enum:
      - Standard
      - ML01
      type: string
      description: "Models of calculating the flight time.<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Standard</b>: Standard model of calculation which takes into account the great circle distance and
        the average speed of all aircraft typically operating on those distances.</li>\r\n<li><b>1 - ML01</b>: Experimental machine learning (ML) model, which attempts to provide more accurate prediction
        of the flight time by taking into account the history of flights on specified route and aircraft type within the recent year. This may come in handy in case when on certain routes flights take significant
        detours due to extended airspace closures dictated by war conflicts, sanction regulations, etc. This can result in significantly increased flight times comparing to regular estimations. Or, some
        routes generally experience longer delays than other routes of the same distance. This model attempts to take such factors into account and reflect it in the prediction. If a model cannot be applied
        due to lack of historical and/or aircraft data or prediction is too off set, it automatically fallbacks to `Standard`.</li>\r\n</ul>\r\n"
    PercentileBracketContract:
      required:
      - delay
      - percentile
      type: object
      properties:
        percentile:
          maximum: 95
          minimum: 5
          type: integer
          description: Percentile of the distribution
          format: int32
        delay:
          type: string
          description: "Delay of the flight for the specific percentile (format: [-]hh:mm:ss)."
          format: date-span
      additionalProperties: false
      description: Percentile bracket contract describing the flight delay for a specific percentile of the distribution
    Pressure:
      required:
      - hPa
      - inHg
      - mmHg
      type: object
      properties:
        hPa:
          type: number
          description: Pressure in hectopascals
          format: double
        inHg:
          type: number
          description: Pressure in inches mercury
          format: double
        mmHg:
          type: number
          description: Pressure in millimeters mercury
          format: double
      additionalProperties: false
    ResourceContract:
      required:
      - license
      - url
      type: object
      properties:
        url:
          minLength: 1
          type: string
          description: URL of the resource
        webUrl:
          type: string
          description: URL of web-page containing the resource
          nullable: true
        author:
          type: string
          description: Author name of the resource
          nullable: true
        title:
          type: string
          description: Title of the resource
          nullable: true
        description:
          type: string
          description: Description of the resource
          nullable: true
        license:
          $ref: "#/components/schemas/LicenseType"
        htmlAttributions:
          type: array
          items:
            type: string
          description: "Attributions maintaining copyright, ownership and other legal information adjusted for displaying\r\nas HTML. Each element represent one line."
          nullable: true
      additionalProperties: false
      description: Single media resource data
    RunwayContract:
      required:
      - isClosed
      - name
      - surface
      - trueHdg
      type: object
      properties:
        name:
          minLength: 1
          type: string
          description: "Name of the runway. E.g.: 27L, 06, 36C, etc."
        trueHdg:
          type: number
          description: True heading of the runway in degrees
          format: double
        length:
          $ref: "#/components/schemas/Distance"
        width:
          $ref: "#/components/schemas/Distance"
        isClosed:
          type: boolean
          description: Marker, if runway is closed
        location:
          $ref: "#/components/schemas/GeoCoordinatesContract"
        surface:
          $ref: "#/components/schemas/SurfaceType"
        displacedThreshold:
          $ref: "#/components/schemas/Distance"
        hasLighting:
          type: boolean
          description: Does runway has lights
          nullable: true
      additionalProperties: false
      description: Single runway data
    SolarStateContract:
      required:
      - dayTime
      - location
      - sunAzimuth
      - sunElevation
      type: object
      properties:
        location:
          $ref: "#/components/schemas/GeoCoordinatesContract"
        sunElevation:
          $ref: "#/components/schemas/Angle"
        sunAzimuth:
          $ref: "#/components/schemas/Azimuth"
        dayTime:
          type: array
          items:
            $ref: "#/components/schemas/DayTime"
          description: Daytime states
        dawnAstronomical:
          $ref: "#/components/schemas/DateTimeContract"
        dawnNautical:
          $ref: "#/components/schemas/DateTimeContract"
        dawnCivil:
          $ref: "#/components/schemas/DateTimeContract"
        sunrise:
          $ref: "#/components/schemas/DateTimeContract"
        noonTrue:
          $ref: "#/components/schemas/DateTimeContract"
        sunset:
          $ref: "#/components/schemas/DateTimeContract"
        duskCivil:
          $ref: "#/components/schemas/DateTimeContract"
        duskNautical:
          $ref: "#/components/schemas/DateTimeContract"
        duskAstronomical:
          $ref: "#/components/schemas/DateTimeContract"
      additionalProperties: false
      description: Solar information at the moment
    Speed:
      required:
      - kmPerHour
      - kt
      - meterPerSecond
      - miPerHour
      type: object
      properties:
        kt:
          type: number
          description: Speed in knots
          format: double
        kmPerHour:
          type: number
          description: Speed in km per hour
          format: double
        miPerHour:
          type: number
          description: Speed in miles per hour
          format: double
        meterPerSecond:
          type: number
          description: Speed in meters per second
          format: double
      additionalProperties: false
    SpeedFlightPlanUnitContract:
      type: object
      properties:
        requested:
          $ref: "#/components/schemas/Speed"
        assigned:
          $ref: "#/components/schemas/Speed"
      additionalProperties: false
      description: "Contract describing unit (altitude, airspeed, etc.) which can be assigned and / or requested\r\nin the context of the flight plan"
    StatisticClass:
      enum:
      - Flight
      - FlightAndHour
      type: string
      description: "<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Flight</b></li>\r\n<li><b>1 - FlightAndHour</b></li>\r\n</ul>\r\n"
    StringAircraftContractSearchResultCollectionContract:
      required:
      - count
      - items
      - searchBy
      type: object
      properties:
        searchBy:
          minLength: 1
          type: string
          description: "Search parameter used to find the result. \r\nPlease note, it may be different from the actual input provided!"
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            $ref: "#/components/schemas/AircraftContract"
          description: The collection of items
      additionalProperties: false
    StringCollectionContract:
      required:
      - count
      - items
      type: object
      properties:
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            type: string
          description: The collection of items
      additionalProperties: false
    StringFlightSearchItemContractSearchResultCollectionContract:
      required:
      - count
      - items
      - searchBy
      type: object
      properties:
        searchBy:
          minLength: 1
          type: string
          description: "Search parameter used to find the result. \r\nPlease note, it may be different from the actual input provided!"
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            $ref: "#/components/schemas/FlightSearchItemContract"
          description: The collection of items
      additionalProperties: false
    StringListingAirportContractSearchResultCollectionContract:
      required:
      - count
      - items
      - searchBy
      type: object
      properties:
        searchBy:
          minLength: 1
          type: string
          description: "Search parameter used to find the result. \r\nPlease note, it may be different from the actual input provided!"
        count:
          maximum: 2147483647
          minimum: 0
          type: integer
          description: The number of items in the collection
          format: int32
          readOnly: true
        items:
          type: array
          items:
            $ref: "#/components/schemas/ListingAirportContract"
          description: The collection of items
      additionalProperties: false
    SubscriberContract:
      required:
      - id
      - type
      type: object
      properties:
        type:
          minLength: 1
          type: string
          description: Type of subscriber. Completemented by SubscriberId.
        id:
          minLength: 1
          type: string
          description: ID
      additionalProperties: false
      description: Describes subscriber (consumer of the subscription)
    SubscriptionBalanceContract:
      required:
      - creditsRemaining
      - lastDeductedUtc
      - lastRefilledUtc
      type: object
      properties:
        creditsRemaining:
          type: integer
          description: Alert credits remaining for the account.
          format: int64
        lastRefilledUtc:
          type: string
          description: The datetime when the balance was last re-filled, in UTC.
          format: date-time
        lastDeductedUtc:
          type: string
          description: "The datetime when the balance was last deducated, in UTC.\r\nDeduction typically occurs when an alert notification was dispatched\r\nfor one of the alert subscriptions associated
            with the user account."
          format: date-time
      additionalProperties: false
      description: "Represents the balance for all alert subscriptions associated with the user acount, including remaining credits and timestamps\r\nfor the most recent refill and deduction operations."
    SubscriptionBillingType:
      enum:
      - LifetimeBased
      - CreditBased
      type: string
      description: "Flight alert subscription billing type<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - LifetimeBased</b>: Subscription billed upon creation based on the life-time with set expiration date-time
        (BEING DEPRECATED)</li>\r\n<li><b>1 - CreditBased</b>: Subscription with no expiration date, billed based on the amount of notifications sent</li>\r\n</ul>\r\n"
    SubscriptionContract:
      required:
      - createdOnUtc
      - id
      - isActive
      - subject
      - subscriber
      type: object
      properties:
        id:
          type: string
          description: "Identifier of a subscription. \r\nUse this ID to control the subscription in future (e.g. update or delete)."
          format: uuid
        isActive:
          type: boolean
          description: Specifies if the subscription is active
        billingType:
          $ref: "#/components/schemas/SubscriptionBillingType"
        activateBeforeUtc:
          type: string
          description: "Time (UTC) before which subscription must be activated (may be applicable to \r\nsome non-active newly created subscriptions)"
          format: date-time
          nullable: true
        expiresOnUtc:
          type: string
          description: "Time (UTC) when subscription expires and will be removed.\r\n\r\nIf not specified, subscription never expires."
          format: date-time
          nullable: true
        createdOnUtc:
          type: string
          description: Time (UTC) when subscription was created
          format: date-time
        subject:
          $ref: "#/components/schemas/SubscriptionSubjectContract"
        subscriber:
          $ref: "#/components/schemas/SubscriberContract"
        notices:
          type: array
          items:
            type: string
          description: Additional messages
          nullable: true
      additionalProperties: false
      description: Describes subscription
    SubscriptionSubjectContract:
      required:
      - type
      type: object
      properties:
        type:
          $ref: "#/components/schemas/SubscriptionSubjectType"
        id:
          type: string
          description: "Subject ID of a subscription. Complements SubjectType.\r\n\r\nE.g. SubjectType = \"FlightNumber\" and SubjectId = \"DL 47\" means that this\r\nsubscription is for all updates of
            flight with number DL47."
          nullable: true
      additionalProperties: false
      description: Describes subscription subject
    SubscriptionSubjectType:
      enum:
      - FlightByNumber
      - FlightByAirportIcao
      type: string
      description: "<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - FlightByNumber</b></li>\r\n<li><b>1 - FlightByAirportIcao</b></li>\r\n</ul>\r\n"
    SubscriptionsBalanceRefillRequestContract:
      required:
      - credits
      type: object
      properties:
        credits:
          maximum: 2147483647
          minimum: 1
          type: integer
          description: Number of credits to add to the notification subscription balance.
          format: int32
      additionalProperties: false
      description: Represents a contract for refilling flight alert credits on a subscription.
    SurfaceType:
      enum:
      - Unknown
      - Asphalt
      - Concrete
      - Grass
      - Dirt
      - Gravel
      - DryLakebed
      - Water
      - Snow
      type: string
      description: "<p>Possible values:</p>\r\n<ul>\r\n<li><b>0 - Unknown</b></li>\r\n<li><b>1 - Asphalt</b></li>\r\n<li><b>2 - Concrete</b></li>\r\n<li><b>3 - Grass</b></li>\r\n<li><b>4 - Dirt</b></li>\r\
        \n<li><b>5 - Gravel</b></li>\r\n<li><b>6 - DryLakebed</b></li>\r\n<li><b>7 - Water</b></li>\r\n<li><b>8 - Snow</b></li>\r\n</ul>\r\n"
  securitySchemes: {}
security: {}
tags:
- name: Aircraft API
- name: Airport API
- name: Flight Alert API
- name: Flight API
- name: Healthcheck API
- name: Industry API
- name: Miscellaneous API
- name: Statistical API