Aircraft API
The Aircraft API provides detailed technical specs on over 900 airplane models from propeller planes to jumbo jets, and decodes ICAO and IATA aircraft type codes (such as A20N or 32N) for over 2,600 aircraft types.
From 9,339 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 290ms | 328ms | 351ms | 492ms | 970ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
https://api.api-ninjas.com/v1/aircraft
Returns a list of aircraft that match the given parameters. Look up a type code with icao or iata, or search by name and performance. Specs cover airplanes only - for helicopter specs please use our Helicopter API. Type-code lookups also decode helicopter and other designators, returning the type details without performance specs.
Parameters
At least one of the following parameters (other than limit) must be set.
manufactureroptionalCompany that designed and built the aircraft.
modeloptionalAircraft model name.
icaooptionalICAO aircraft type designator, e.g.
A320,B738,A20N. Exact match, case-insensitive.iataoptionalIATA aircraft type code, e.g.
320,32N,73H. Family codes such as32S,737orATRreturn every type in the family.engine_typeoptionalType of engine. Must be one of:
piston,propjet,jet.min_speedoptionalMinimum max. air speed in knots (inclusive).
max_speedoptionalMaximum max. air speed in knots (inclusive).
min_rangeoptionalMinimum range of the aircraft in nautical miles (inclusive).
max_rangeoptionalMaximum range of the aircraft in nautical miles (inclusive).
min_lengthoptionalMinimum length of the aircraft in feet (inclusive).
max_lengthoptionalMaximum length of the aircraft in feet (inclusive).
min_heightoptionalMinimum height of the aircraft in feet (inclusive).
max_heightoptionalMaximum height of the aircraft in feet (inclusive).
min_wingspanoptionalMinimum wingspan of the aircraft in feet (inclusive).
max_wingspanoptionalMaximum wingspan of the aircraft in feet (inclusive).
limitoptionalHow many results to return. Must be between
1and30. Default is1.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/aircraft endpoint returns a JSON array of objects, each with the following fields, or an error if the request is unsuccessful. Fields without data are omitted; records for type codes we have no specs for contain only the type fields.
manufacturerCompany that designed and built the aircraft.
modelAircraft model name.
notesVariant or spec remarks, when present (e.g. serial-number ranges or model-year differences).
icao_typeICAO aircraft type designator.
iata_typesArray of IATA aircraft type codes for this ICAO type, when assigned.
aircraft_classFixed-wing Landplane,Fixed-wing Amphibian,Fixed-wing Seaplane,Helicopter,GyroplaneorPowered-lift.engine_countNumber of engines (integer).
engine_typeType of engine (e.g., "Jet", "Piston", "Propjet").
engine_horsepowerHorsepower per engine (piston and propjet aircraft).
engine_thrust_lbfThrust per engine in pounds-force (jet aircraft).
engine_thrust_lb_ftDeprecated: horsepower for piston and propjet aircraft, pounds of thrust for jets. Use
engine_horsepowerorengine_thrust_lbfinstead.max_speed_knotsMaximum air speed in knots.
cruise_speed_knotsCruise speed in knots.
stall_knotsStall speed in knots.
ceiling_ftService ceiling in feet.
rate_of_climb_ft_per_minRate of climb in feet per minute.
takeoff_over_50ft_ftTakeoff distance over a 50 ft obstacle, in feet.
takeoff_ground_run_ftTakeoff ground run distance in feet.
landing_over_50ft_ftLanding distance over a 50 ft obstacle, in feet.
landing_ground_roll_ftLanding ground roll distance in feet.
gross_weight_lbsGross (maximum takeoff) weight in pounds.
empty_weight_lbsEmpty weight in pounds.
length_ftLength in feet.
height_ftHeight in feet.
wing_span_ftWingspan in feet.
range_nautical_milesRange in nautical miles.
faa_weight_classFAA weight class:
Small,Small+,Large,HeavyorSuper.icao_wake_categoryICAO wake turbulence category:
Light,Medium,HeavyorSuper.faa_cwt_categoryFAA consolidated wake turbulence (CWT) category,
AtoI.
Live Demo
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/aircraft?manufacturer=Gulfstream&model=G550" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the Aircraft API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Aircraft API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Aircraft API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Aircraft API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I look up a specific aircraft model with the Aircraft API?
Pass themanufacturerand/ormodelquery parameters to the/v1/aircraftendpoint, for example manufacturer=Gulfstream and model=G550. At least one parameter (other thanlimit) must be set, and you can return up to 30 matches by adjusting thelimitparameter (default1). Get a free API key by registering for an account.Can I look up aircraft by ICAO or IATA type code?
Yes. Pass an ICAO type designator withicao(for exampleicao=A20Nfor the Airbus A320neo oricao=B738for the Boeing 737-800), or an IATA aircraft type code withiata(for exampleiata=32Noriata=73H). IATA family codes such as32S,737orATRreturn every type in the family. Every result includesicao_typeand, where assigned,iata_types, so you can match the aircraft codes used in flight schedules, departure boards and airline fleet lists. See the Airports API for airport codes.What technical specs does the Aircraft API return for each airplane?
Each result includes theicao_typeandiata_typescodes,engine_count, wake turbulence categories, and performance and dimension fields such asengine_type,engine_horsepowerorengine_thrust_lbf,max_speed_knots,cruise_speed_knots,ceiling_ft,range_nautical_miles,length_ft,height_ft,wing_span_ft, and weight fields likegross_weight_lbsandempty_weight_lbs. If a request is unsuccessful you receive an error instead, documented on our error codes page.Can I filter aircraft by performance characteristics instead of by name?
Yes, you can search by ranges using parameters likemin_speed,max_speed,min_range,max_range,min_length, andmax_wingspan, and you can restrict byengine_type(one ofpiston,propjet, orjet). Browse all API Ninjas APIs for related transportation data.Does the Aircraft API cover helicopters?
The Aircraft API's specs cover airplanes only, over 900 models from propeller planes to jumbo jets; for rotorcraft specs use the Helicopter API instead. Looking up a helicopter's ICAO type code withicaostill returns its type details (class, engines and wake category) without performance specs. You can also explore the Airlines and Airports APIs for more aviation data.
Explore API integration use cases for recommended APIs and workflow examples.