ADS-B Exchange · Example Payload

Getapiaircraftv2Operationsairport

Returns operations (Takeoffs and Landings) for the given ICAO code of the airport. Response is paginated and sorted by time (descending). Returns 20 items per page. Get operations for San Francisco airport for the last 24 hours: ``` GET /api/aircraft/v2/operations/airport/KSFO ``` Use https://www.world-airport-codes.com/ to find ICAO codes for airports.

AviationFlight TrackingADS-BAircraftReal-TimeMilitaryMLAT

Getapiaircraftv2Operationsairport 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

Raw ↑
{
  "operationId": "GetApiAircraftV2OperationsAirport",
  "summary": "Get operations by airport",
  "description": "Returns operations (Takeoffs and Landings) for the given ICAO code of the airport. Response is paginated and sorted by time (descending). Returns 20 items per page.\n\nGet operations for San Francisco airport for the last 24 hours:\n```\nGET /api/aircraft/v2/operations/airport/KSFO\n```\nUse https://www.world-airport-codes.com/ to find ICAO codes for airports.",
  "method": "GET",
  "path": "/operations/airport/{airport}",
  "parameters": [
    {
      "name": "airport",
      "in": "path",
      "required": true,
      "description": "ICAO code of the airport.",
      "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": {}
    }
  }
}