{
  "openapi": "3.1.0",
  "info": {
    "title": "Aircraft API",
    "version": "1.0.0",
    "description": "7,259 ICAO aircraft type designators with class, engines, wake category and FAA dimensions for 1,744 types.\n\nAircraft type catalog built from official aviation data: 7,200+ ICAO Doc 8643 type designators (every aircraft type provided with air traffic service) — designator, manufacturer, model, description code, aircraft class (landplane, helicopter, amphibian, gyrocopter, tiltrotor), engine type and count, wake turbulence category and group — with 1,700+ types enriched by the FAA Aircraft Characteristics Database: approach speed, wingspan, length, tail height, maximum takeoff and landing weights, approach category, airplane and taxiway design groups, parking area, and US registration counts. Look up every variant behind an ICAO designator (e.g. B738), filter by manufacturer, aircraft class, engine type/count, wake category or minimum MTOW; aggregate manufacturers and engine types. Self-hosted dataset from ICAO and FAA publications, refreshed daily — no third-party calls.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/aircraft.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/aircraft"
  },
  "servers": [
    {
      "url": "https://api-aircraft.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Data",
      "description": "Aircraft API belongs to the Data category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/aircraft/manufacturers": {
      "get": {
        "operationId": "aircraftManufacturers",
        "summary": "Aircraft Manufacturers",
        "description": "Aircraft Manufacturers endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/aircraft-manufacturers"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "airbus"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 3,
                  "manufacturers": [
                    {
                      "manufacturer": "AIRBUS",
                      "count": 79
                    },
                    {
                      "manufacturer": "AIRBUS HELICOPTERS",
                      "count": 33
                    },
                    {
                      "manufacturer": "AIRBUS HELICOPTERS-KAWASAKI",
                      "count": 8
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/aircraft/engine-types": {
      "get": {
        "operationId": "engineTypes",
        "summary": "Engine Types",
        "description": "Engine Types endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/engine-types"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 8,
                  "engineTypes": [
                    {
                      "engineType": "Piston",
                      "count": 4412
                    },
                    {
                      "engineType": "Turboprop/Turboshaft",
                      "count": 1622
                    },
                    {
                      "engineType": "Jet",
                      "count": 1207
                    },
                    {
                      "engineType": "Electric",
                      "count": 16
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/aircraft/{idOrSlug}": {
      "get": {
        "operationId": "getAircraft",
        "summary": "Get Aircraft",
        "description": "Get Aircraft endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/get-aircraft"
        },
        "parameters": [
          {
            "name": "idOrSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b738-boeing-737-800"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "id": 1042,
                  "slug": "b738-boeing-737-800",
                  "designator": "B738",
                  "model": "737-800",
                  "manufacturer": "BOEING",
                  "descriptionCode": "L2J",
                  "aircraftType": "LandPlane",
                  "engine": {
                    "type": "Jet",
                    "count": "2"
                  },
                  "wakeTurbulenceCategory": "M",
                  "wakeTurbulenceGroup": "D",
                  "hasCharacteristics": true,
                  "characteristics": {
                    "approachSpeedKt": 144,
                    "wingspanFt": 112.6,
                    "lengthFt": 129.5,
                    "tailHeightFt": 41.3,
                    "mtowLb": 174200,
                    "malwLb": 146300,
                    "approachCategory": "D",
                    "airplaneDesignGroup": "III",
                    "taxiwayDesignGroup": "3",
                    "parkingAreaFt2": 14583,
                    "usRegistrationCount": 971
                  },
                  "faaRecord": {
                    "ICAO_Code": "B738",
                    "FAA_Designator": "B738",
                    "Manufacturer": "BOEING",
                    "Model_FAA": "Boeing 737-800",
                    "Physical_Class_Engine": "Jet",
                    "Num_Engines": "2",
                    "...": "41 columns total"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/aircraft": {
      "get": {
        "operationId": "listAircraft",
        "summary": "List Aircraft",
        "description": "List Aircraft endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/list-aircraft"
        },
        "parameters": [
          {
            "name": "designator",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "B738"
          },
          {
            "name": "engineCount",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2"
          },
          {
            "name": "engineType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Jet"
          },
          {
            "name": "hasCharacteristics",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "true"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "manufacturer",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BOEING"
          },
          {
            "name": "minMtowLb",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "800000"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "737"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Helicopter"
          },
          {
            "name": "wtc",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "H"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "total": 178,
                  "page": 1,
                  "limit": 20,
                  "count": 1,
                  "results": [
                    {
                      "id": 1042,
                      "slug": "b738-boeing-737-800",
                      "designator": "B738",
                      "model": "737-800",
                      "manufacturer": "BOEING",
                      "descriptionCode": "L2J",
                      "aircraftType": "LandPlane",
                      "engine": {
                        "type": "Jet",
                        "count": "2"
                      },
                      "wakeTurbulenceCategory": "M",
                      "wakeTurbulenceGroup": "D",
                      "hasCharacteristics": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/aircraft/designator/{code}": {
      "get": {
        "operationId": "lookupByDesignator",
        "summary": "Lookup By Designator",
        "description": "Lookup By Designator endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/lookup-by-designator"
        },
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "B738"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "designator": "A320",
                  "count": 2,
                  "results": [
                    {
                      "slug": "a320-airbus-a-320",
                      "model": "A-320",
                      "manufacturer": "AIRBUS",
                      "engine": {
                        "type": "Jet",
                        "count": "2"
                      },
                      "wakeTurbulenceCategory": "M"
                    },
                    {
                      "slug": "a320-airbus-a-320-prestige",
                      "model": "A-320 Prestige",
                      "manufacturer": "AIRBUS",
                      "engine": {
                        "type": "Jet",
                        "count": "2"
                      },
                      "wakeTurbulenceCategory": "M"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/aircraft/random": {
      "get": {
        "operationId": "randomAircraft",
        "summary": "Random Aircraft",
        "description": "Random Aircraft endpoint of the Aircraft API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/aircraft/random-aircraft"
        },
        "parameters": [
          {
            "name": "amount",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "3"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 2,
                  "results": [
                    {
                      "slug": "c101-casa-t-36-aviojet",
                      "designator": "C101",
                      "model": "T-36 Aviojet",
                      "manufacturer": "CASA",
                      "aircraftType": "LandPlane",
                      "engine": {
                        "type": "Jet",
                        "count": "1"
                      }
                    },
                    {
                      "slug": "cozy-co-z-cozy",
                      "designator": "COZY",
                      "model": "Cozy",
                      "manufacturer": "CO-Z",
                      "aircraftType": "LandPlane",
                      "engine": {
                        "type": "Piston",
                        "count": "1"
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}