ADS-B Exchange · Example Payload

Postapiaircraftv2Operationsairports

Returns operations (Takeoffs and Landings) for the given ICAO codes of the airports. Response is paginated and sorted by time (descending). Returns 1000 items per page. Max number of airports per request is 500 (hard limit), further constrained by AirportLimit entitlement. **Example**: get operations for three main California airports (Los Angeles, San Francisco, San Diego): ``` POST /api/aircraft/v2/operations/airports { "airports": ["KLAX", "KSFO", "KSAN"] } ```

AviationFlight TrackingADS-BAircraftReal-TimeMilitaryMLAT

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

Top-level fields

operationIdsummarydescriptionmethodpathparametersresponsesrequestBody

Example Payload

{
  "operationId": "PostApiAircraftV2OperationsAirports",
  "summary": "Get operations by multiple airports",
  "description": "Returns operations (Takeoffs and Landings) for the given ICAO codes of the airports. Response is paginated and sorted by time (descending). Returns 1000 items per page.\nMax number of airports per request is 500 (hard limit), further constrained by AirportLimit entitlement.\n\n**Example**: get operations for three main California airports (Los Angeles, San Francisco, San Diego):\n```\nPOST /api/aircraft/v2/operations/airports\n            \n{\n    \"airports\": [\"KLAX\", \"KSFO\", \"KSAN\"]\n}\n```",
  "method": "POST",
  "path": "/operations/airports",
  "parameters": [
    {
      "name": "page",
      "x-originalName": "pageNumber",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "int32",
        "nullable": true
      },
      "x-position": 2
    },
    {
      "name": "time_from",
      "x-originalName": "unixTimestampFrom",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "int64",
        "nullable": true
      },
      "x-position": 3
    },
    {
      "name": "time_to",
      "x-originalName": "unixTimestampTo",
      "in": "query",
      "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": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/OperationsResponse"
      },
      "example": {}
    },
    "400": {
      "description": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/BadRequest"
      },
      "example": {}
    },
    "402": {
      "description": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiUnauthorizedResponse"
      },
      "example": {}
    },
    "403": {
      "description": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiForbiddenResponse"
      },
      "example": {}
    },
    "429": {
      "description": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ApiTooManyRequestsResponse"
      },
      "example": {}
    },
    "500": {
      "description": "",
      "content_type": "application/json",
      "schema": {
        "$ref": "#/components/schemas/ProblemDetails"
      },
      "example": {}
    }
  },
  "requestBody": {
    "x-name": "request",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/OperationsAirportRequest"
        }
      }
    },
    "required": true,
    "x-position": 1
  }
}