api-ninjas-com Aircraft API

openapi: 3.2.0
info:
  title: Ninjas Aircraft API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Aircraft
  description: The Aircraft API provides technical specs on over 900 airplane models, from propeller planes to jumbo jets, and decodes ICAO and IATA aircraft type codes for over 2,600 aircraft types.
paths:
  /v1/aircraft:
    get:
      tags:
      - Aircraft
      summary: Get aircraft details
      description: 'Returns airplane specs matching the given filters, or decodes an ICAO (icao=A20N) or IATA (iata=32N) aircraft type code. At least one parameter other than limit is required. Helicopter specs: /v1/helicopter.'
      operationId: getAircraft
      parameters:
      - $ref: '#/components/parameters/manufacturer'
      - $ref: '#/components/parameters/model'
      - $ref: '#/components/parameters/icao'
      - $ref: '#/components/parameters/iata'
      - $ref: '#/components/parameters/engine_type'
      - $ref: '#/components/parameters/min_speed'
      - $ref: '#/components/parameters/max_speed'
      - $ref: '#/components/parameters/min_range'
      - $ref: '#/components/parameters/max_range'
      - $ref: '#/components/parameters/min_length'
      - $ref: '#/components/parameters/max_length'
      - $ref: '#/components/parameters/min_height'
      - $ref: '#/components/parameters/max_height'
      - $ref: '#/components/parameters/min_wingspan'
      - $ref: '#/components/parameters/max_wingspan'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AircraftResponse'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  parameters:
    max_height:
      name: max_height
      in: query
      description: Maximum height of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    min_range:
      name: min_range
      in: query
      description: Minimum range of the aircraft in nautical miles (inclusive).
      required: false
      schema:
        type: integer
    max_length:
      name: max_length
      in: query
      description: Maximum length of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    manufacturer:
      name: manufacturer
      in: query
      description: Company that designed and built the aircraft.
      required: false
      schema:
        type: string
    min_speed:
      name: min_speed
      in: query
      description: Minimum max. air speed in knots (inclusive).
      required: false
      schema:
        type: integer
    min_length:
      name: min_length
      in: query
      description: Minimum length of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    min_height:
      name: min_height
      in: query
      description: Minimum height of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    iata:
      name: iata
      in: query
      description: IATA aircraft type code, e.g. 320, 32N, 73H. Family codes such as 32S, 737 or ATR return every type in the family.
      required: false
      schema:
        type: string
    max_speed:
      name: max_speed
      in: query
      description: Maximum max. air speed in knots (inclusive).
      required: false
      schema:
        type: integer
    limit:
      name: limit
      in: query
      description: How many results to return. Must be between 1 and 30. Default is 1.
      required: false
      schema:
        type: integer
        default: 1
        minimum: 1
        maximum: 30
    max_range:
      name: max_range
      in: query
      description: Maximum range of the aircraft in nautical miles (inclusive).
      required: false
      schema:
        type: integer
    model:
      name: model
      in: query
      description: Aircraft model name.
      required: false
      schema:
        type: string
    min_wingspan:
      name: min_wingspan
      in: query
      description: Minimum wingspan of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    icao:
      name: icao
      in: query
      description: ICAO aircraft type designator, e.g. A320, B738, A20N. Exact match, case-insensitive. Also decodes types we have no specs for (e.g. helicopters).
      required: false
      schema:
        type: string
    max_wingspan:
      name: max_wingspan
      in: query
      description: Maximum wingspan of the aircraft in feet (inclusive).
      required: false
      schema:
        type: integer
    engine_type:
      name: engine_type
      in: query
      description: 'Type of engine. Must be one of: piston, propjet, jet.'
      required: false
      schema:
        type: string
        enum:
        - piston
        - propjet
        - jet
  schemas:
    AircraftResponse:
      type: array
      items:
        type: object
        properties:
          manufacturer:
            type: string
            example: Gulfstream Aerospace
            description: Company that designed and built the aircraft.
          model:
            type: string
            example: G550
            description: Aircraft model name.
          notes:
            type: string
            example: prior '79 serv. ceiling=29,100
            description: Variant or spec remarks (e.g. serial ranges or model-year differences).
          icao_type:
            type: string
            example: GLF5
            description: ICAO aircraft type designator.
          iata_types:
            type: array
            items:
              type: string
            example:
            - '320'
            - 32A
            description: IATA aircraft type codes for this ICAO type, when assigned (e.g. 320 and 32A for the A320).
          aircraft_class:
            type: string
            example: Fixed-wing Landplane
            description: Fixed-wing Landplane, Fixed-wing Amphibian, Fixed-wing Seaplane, Helicopter, Gyroplane or Powered-lift.
          engine_count:
            type: integer
            example: 2
            description: Number of engines.
          engine_type:
            type: string
            example: Jet
            description: 'Type of engine: Jet, Propjet or Piston (Turboshaft, Electric or Rocket for some type-only records).'
          engine_horsepower:
            type: string
            description: Horsepower per engine (piston and propjet aircraft).
            example: '285'
          engine_thrust_lbf:
            type: string
            example: '15385'
            description: Thrust per engine in pounds-force (jet aircraft).
          engine_thrust_lb_ft:
            type: string
            example: '15385'
            description: 'Deprecated: horsepower for piston and propjet aircraft, pounds of thrust for jets. Use engine_horsepower or engine_thrust_lbf.'
          max_speed_knots:
            type: string
            example: '590'
            description: Maximum air speed in knots.
          cruise_speed_knots:
            type: string
            example: '566'
            description: Cruise speed in knots.
          stall_knots:
            type: string
            description: Stall speed in knots.
          ceiling_ft:
            type: string
            example: '51000'
            description: Service ceiling in feet.
          rate_of_climb_ft_per_min:
            type: string
            description: Rate of climb in feet per minute.
          takeoff_over_50ft_ft:
            type: string
            description: Takeoff distance over a 50 ft obstacle, in feet.
          takeoff_ground_run_ft:
            type: string
            example: '5910'
            description: Takeoff ground run distance in feet.
          landing_over_50ft_ft:
            type: string
            description: Landing distance over a 50 ft obstacle, in feet.
          landing_ground_roll_ft:
            type: string
            example: '2770'
            description: Landing ground roll distance in feet.
          gross_weight_lbs:
            type: string
            example: '91000'
            description: Gross (maximum takeoff) weight in pounds.
          empty_weight_lbs:
            type: string
            example: '47900'
            description: Empty weight in pounds.
          length_ft:
            type: string
            example: '96.417'
            description: Length in feet.
          height_ft:
            type: string
            example: '25.833'
            description: Height in feet.
          wing_span_ft:
            type: string
            example: '93.5'
            description: Wingspan in feet.
          range_nautical_miles:
            type: string
            example: '6750'
            description: Range in nautical miles.
          faa_weight_class:
            type: string
            example: Large
            description: 'FAA weight class: Small, Small+, Large, Heavy or Super.'
          icao_wake_category:
            type: string
            example: Medium
            description: 'ICAO wake turbulence category: Light, Medium, Heavy or Super.'
          faa_cwt_category:
            type: string
            example: F
            description: FAA consolidated wake turbulence (CWT) category, A to I.
          image_url:
            type: string
            format: uri
            description: Image URL. Business tier and above.
            example: https://media.api-ninjas.com/aircraft_images/generated/GLF5_gulfstream-g550.png
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api