airfleets.net APIairfleets.net ↗
Access aircraft details, airline fleet compositions, age statistics, delivery records, and operator history from airfleets.net via 9 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/359ab7ca-96d6-40f0-909e-de207236e50f/search_aircraft?query=F-GKXS' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for aircraft by registration or MSN. Returns matching aircraft with basic info including type, airline, status, and link to details.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword such as aircraft registration (e.g. F-GKXS) or MSN (e.g. 3825). |
{
"type": "object",
"fields": {
"query": "string, the search term used",
"results": "array of aircraft objects with registration, msn, type, airline, status, details_url"
},
"sample": {
"data": {
"query": "F-GKXS",
"results": [
{
"msn": "3825",
"type": "Airbus A320",
"status": "Active",
"airline": "Air France",
"details_url": "https://www.airfleets.net/ficheapp/plane-a320-3825.htm",
"registration": "F-GKXS"
}
]
},
"status": "success"
}
}About the airfleets.net API
The Airfleets.net API provides 9 endpoints covering aircraft search, full operator history, airline fleet composition, and fleet age statistics sourced from airfleets.net. You can look up an individual aircraft by MSN or registration using get_aircraft_details, browse entire airline fleets with get_airline_fleet, or track the latest deliveries with get_new_aircraft_deliveries. Response fields include subtype, first flight date, delivery date, and per-type active, parked, stored, and on-order counts.
Aircraft Lookup and History
The search_aircraft endpoint accepts a registration (e.g. F-GKXS) or MSN (e.g. 3825) and returns an array of matching aircraft with type, airline, status, and a details URL. From there, get_aircraft_details takes the MSN and a type code (e.g. a320, b737ng) and returns the full operator history — an array of entries each containing registration, airline, delivery date, and remarks — alongside first flight date, current status, and specific subtype (e.g. 320-214).
Fleet Composition and Age
get_airline_fleet returns a fleet_composition array broken down by aircraft type with counts for active, parked, stored/scrapped, on-order, and historical frames. When you need age data, get_airline_fleet_age returns a per-type breakdown of count and average age, plus an overall fleet average. Both endpoints accept an airline name string; use search_airline first to confirm the exact name used on airfleets.net before querying fleet endpoints.
Type-Level Fleet History and Filtering
get_airline_fleet_history_by_type narrows to a single aircraft type at a given airline and accepts an optional status filter (active, stored, or history). Each record in the aircraft array includes MSN, subtype, registration, from/to dates, and remarks. This is useful for building a complete picture of how an airline's specific narrowbody or widebody fleet evolved over time.
Deliveries, Updates, and Country Browsing
get_new_aircraft_deliveries returns recent delivery records with aircraft type, MSN, registration, airline, and delivery date — no inputs required. get_last_aircraft_updates surfaces recently modified records in the same structure. get_airlines_by_country accepts a country name and an optional page number, returning up to 20 airlines per page; note that the United States is listed as USA in the country parameter.
- Track newly delivered narrowbody and widebody aircraft by airline using
get_new_aircraft_deliveries - Build fleet age comparison tools across carriers using
get_airline_fleet_ageaverage_age and count fields - Audit an airline's historical fleet transitions by type and status with
get_airline_fleet_history_by_type - Verify aircraft ownership and operator history by MSN before an aircraft transaction using
get_aircraft_details - Enumerate all airlines registered in a given country using
get_airlines_by_countrywith pagination - Monitor aircraft record changes over time by polling
get_last_aircraft_updates - Cross-reference fleet on-order counts by type to analyze aircraft procurement trends via
get_airline_fleet
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does airfleets.net have an official developer API?+
What does `get_aircraft_details` return beyond basic specs?+
Does `get_airline_fleet` return individual tail numbers or only aggregate counts?+
get_airline_fleet returns aggregate counts per aircraft type — active, parked, stored/scrapped, on-order, and total. Individual tail numbers and MSNs are not included at this level. To retrieve individual aircraft records with registration and MSN, use get_airline_fleet_history_by_type with the relevant type code and status filter. You can fork this API on Parse and revise it to add a dedicated endpoint if you need bulk individual aircraft export at the fleet level.Is there an endpoint to retrieve aircraft photos or images?+
How should I find the correct airline name to use in fleet endpoints?+
get_airline_fleet, get_airline_fleet_age, and get_airline_fleet_history_by_type must match the names used on airfleets.net exactly. Run search_airline with a partial or full airline name first to retrieve the exact string. Passing a mismatched name will return empty or no results.