api-ninjas-com Aircraft API
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.
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.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/api-ninjas-com:api-ninjas-com-aircraft-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
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