Aircraft API

Download OpenAPI specification:Download

Introduction

The Aircraft APIs, part of the FlightStats APIs, provides extensive information on specific aircraft.

Evaluation plans are limited to the British Airways fleet (Company ID #-456).

Aircraft APIs answer questions such as:

  • How old is an aircraft?
  • Who owns an aircraft?
  • What engines are on the aircraft?

The primary APIs are the aircraft apis where you can search by a specific piece of aircraft and get all the details about it, or a list of aircraft matching certain search criteria.

The details returned will depend on the information your contract is entitled to returned. There is an API to see a list of all possible data items, as well as an API where you can see the fields your contract is entitled to. These field names can be passed into the Aircraft search APIs to constrain the amount of information returned to just what is necessary for your application.

There are also 2 company APIs that allow you to look up airlines, lessors, etc.. as well as return the fleet information associated with the company.

Licensing

The Aircraft APIs are premium APIs and only included in our Contract plan.

A breakdown of the available plans is available on Get evaluation account

Schemas

Click the download button at the top of this document to download the OpenApi spec for this API. Other schemas:

APIs REST - JSON

Related products

Airline - Reference data for Airlines

Airline Reference Data (Laminar Data Hub) - Airline reference data for Laminar Data Hub

Equipment - Reference data for Equipement

Authentication

appIdQueryParam

ID of the application making the request

Security Scheme Type API Key
Query parameter name: appId

appKeyQueryParam

Authentication key of the application making the request

Security Scheme Type API Key
Query parameter name: appKey

appIdHeader

ID of the application making the request

Security Scheme Type API Key
Header parameter name: appId

appKeyHeader

Authentication key of the application making the request

Security Scheme Type API Key
Header parameter name: appKey

Aircraft search

Retrieve details about matching aircraft

query Parameters
aircraftSearchProperty
string

The search property (can be header or query param). Supported fields: registration, serialnumber

aircraftSearchValue
string

The property value to match (can be header or query param)

extendedOptions
Array of strings

Extended options for modifying standard API behavior to fit special use cases

header Parameters
aircraftSearchProperty
string

The search property (can be header or query param). Supported fields: registration, serialnumber

aircraftSearchValue
string

The property value to match (can be header or query param)

Request Body schema: */*

Enter '[]' to return all entitled fields or a JSON list of fields to request only specific fields

string

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "request": {
    },
  • "error": {
    },
  • "aircraft": {
    },
  • "aircrafts": {
    },
  • "allowedFields": [
    ],
  • "companies": {
    },
  • "companyAircraftList": {
    }
}

All fields

List all possible fields

query Parameters
extendedOptions
Array of strings

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "request": {
    },
  • "error": {
    },
  • "aircraft": {
    },
  • "aircrafts": {
    },
  • "allowedFields": [
    ],
  • "companies": {
    },
  • "companyAircraftList": {
    }
}

By aircraft ID

Retrieve details about an aircraft

path Parameters
id
required
string

The unique id of the aircraft

query Parameters
extendedOptions
Array of strings

Extended options for modifying standard API behavior to fit special use cases

Request Body schema: */*

Enter '[]' to return all entitled fields or a JSON list of fields to request only specific fields

string

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "request": {
    },
  • "error": {
    },
  • "aircraft": {
    },
  • "aircrafts": {
    },
  • "allowedFields": [
    ],
  • "companies": {
    },
  • "companyAircraftList": {
    }
}

By company ID

List the aircraft belonging to a company

path Parameters
id
required
string
Example: -456

The unique id of the company. You can retrieve this value by doing a company search.

query Parameters
extendedOptions
Array of strings

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "request": {
    },
  • "error": {
    },
  • "aircraft": {
    },
  • "aircrafts": {
    },
  • "allowedFields": [
    ],
  • "companies": {
    },
  • "companyAircraftList": {
    }
}

Company search

List the companies matching the search term

path Parameters
term
required
string
Example: American

The company name to search

query Parameters
extendedOptions
Array of strings

Extended options for modifying standard API behavior to fit special use cases

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "request": {