ADS-B Exchange · Example Payload

Getapiaircraftv2Operationsicao

Returns operations (Takeoffs and Landings) for the given ICAO code (hex code) of the aircraft. Response is paginated and sorted by time (descending). Returns 20 items per page. ``` GET /api/aircraft/v2/operations/icao/A1B2C3 ```

AviationFlight TrackingADS-BAircraftReal-TimeMilitaryMLAT

Getapiaircraftv2Operationsicao is an example object payload from ADS-B Exchange, with 7 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdsummarydescriptionmethodpathparametersresponses

Example Payload

{
  "operationId": "GetApiAircraftV2OperationsIcao",
  "summary": "Get operations by aircraft",
  "description": "Returns operations (Takeoffs and Landings) for the given ICAO code (hex code) of the aircraft.\nResponse is paginated and sorted by time (descending). Returns 20 items per page.\n\n```\nGET /api/aircraft/v2/operations/icao/A1B2C3\n```",
  "method": "GET",
  "path": "/operations/icao/{icao}",
  "parameters": [
    {
      "name": "icao",
      "in": "path",
      "required": true,
      "description": "ICAO code of the aircraft.",
      "schema": {
        "type": "string"
      },
      "x-position": 1
    },
    {
      "name": "page",
      "x-originalName": "pageNumber",
      "in": "query",
      "description": "Page number to return. When not specified, defaults to 1.",
      "schema": {
        "type": "integer",
        "format": "int32",
        "nullable": true
      },
      "x-position": 2
    },
    {
      "name": "time_from",
      "x-originalName": "unixTimestampFrom",
      "in": "query",
      "description": "Unix timestamp from which to start the search. When not specified, defaults to 24 hours ago. Value in seconds.",
      "schema": {
        "type": "integer",
        "format": "int64",
        "nullable": true
      },
      "x-position": 3
    },
    {
      "name": "time_to",
      "x-originalName": "unixTimestampTo",
      "in": "query",
      "description": "Unix timestamp to which to end the search. When not specified, defaults to current time. Value in seconds.",
      "schema": {
        "type": "integer",
        "format": "int64",
        "nullable": true
      },
      "x-position": 4
    },
    {
      "type": "string",
      "name": "Accept-Encoding",
      "in": "header",
      "required": true,
      "description": "The encoding type the client will accept in the response. API call must use compression.",
      "default": "gzip",
      "example": "gzip"
    }
  ],
  "responses": {
    "200": {
      "description": "Response containing a collection of operational events: takeoffs and landings.",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/OperationsResponse"
      },
      "example": {}
    },
    "402": {
      "description": "Payment Required",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiUnauthorizedResponse"
      },
      "example": {}
    },
    "403": {
      "description": "Forbidden",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiForbiddenResponse"
      },
      "example": {}
    },
    "429": {
      "description": "Rate Limit Exceeded",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiTooManyRequestsResponse"
      },
      "example": {}
    },
    "500": {
      "description": "Server Error",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ProblemDetails"
      },
      "example": {}
    }
  }
}