> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flystack.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Airlines Dataset

> Search and filter airlines worldwide using IATA/ICAO codes, callsigns, and operational flags.

Airlines data is essential for almost any travel product—whether you build B2B tools or B2C experiences. A complete, reliable airlines dataset helps your app meet user expectations and lets your team focus on what matters most.

Use the Airlines Dataset endpoint to retrieve airlines worldwide and filter them by common aviation identifiers, names, and country.

### Authentication

**x-api-key** `string` *required*

Your FlyStack API token. You can create one from the dashboard (see [Authentication](https://docs.flystack.dev/authentication.md)).

### Query parameters

#### Airline identifiers

**iata\_code** `string`

Filter by airline IATA code (e.g., `AA`).

**icao\_code** `string`

Filter by airline ICAO code (e.g., `AAL`).

**callsign** `string`

Filter by ICAO callsign (e.g., `AMERICAN`).

#### Additional filters

**iata\_prefix** `number`

Filter by IATA 3-digit airline prefix number.

**iata\_accounting** `number`

Filter by IATA accounting number.

**name** `string`

Filter by airline name (e.g., `American Airlines`).

**country\_code** `string`

Filter by country ISO-2 code (e.g., `US`).

#### Response shaping

**\_fields** `string`

Comma-separated list of fields to return (e.g., `name,iata_code,icao_code,callsign,country_code`).

> [!NOTE]
>
> The response can be shortened for readability when using `_fields`. Data coverage may vary by airline.

#### Pagination

**limit** `number`

Max number of rows per response: 1,000 by default, up to 10,000 (limits may depend on your plan).

**offset** `number`

Pagination offset (0+). When more rows match, the response has the headers `X-Has-More: true` and `X-Next-Offset`: pass its value as `offset` to get the next page.

### Response

The endpoint returns a list of airlines.

#### Airlines dataset response fields

**name** `string`

Public airline name.

**iata\_prefix** `number`

IATA 3-digit airline prefix number (cargo operations, when available).

**iata\_accounting** `number`

IATA 3-digit accounting number (passenger operations, when available).

**iata\_code** `string`

Official IATA code.

**icao\_code** `string`

Official ICAO code.

**callsign** `string`

Allocated ICAO callsign (when available).

**country\_code** `string`

ISO-2 country code.

**Operational flags**

**iosa\_registered** `number`

IATA Operational Safety Audit Program flag (0/1, when available).

**is\_scheduled** `number`

Scheduled airline flag (0/1, when available).

**is\_passenger** `number`

Passenger services flag (0/1, when available).

**is\_cargo** `number`

Cargo services flag (0/1, when available).

**is\_international** `number`

International operations flag (0/1, when available).

**Enrichment**

**total\_aircrafts** `number`

Confirmed total aircraft count (when available).

**average\_fleet\_age** `number`

Average fleet age (years, when available).

**accidents\_last\_5y** `number`

Accidents in the last 5 years (when available).

**crashes\_last\_5y** `number`

Crashes in the last 5 years (when available).

**Links**

**website** `string`

Official website (when available).

**facebook** `string`

Official Facebook profile (when available).

**twitter** `string`

Official Twitter/X profile (when available).

**instagram** `string`

Official Instagram profile (when available).

**linkedin** `string`

Official LinkedIn profile (when available).

**slug** `string`

Unique airline identifier.

```json ?iata_code=AA theme={null}
[
  {
    "name": "American Airlines",
    "iata_code": "AA",
    "iata_prefix": 1,
    "iata_accounting": 1,
    "icao_code": "AAL",
    "callsign": "AMERICAN",
    "country_code": "US",
    "iosa_registered": null,
    "is_scheduled": 1,
    "is_passenger": null,
    "is_cargo": null,
    "is_international": 1,
    "total_aircrafts": 864,
    "average_fleet_age": 14.0,
    "accidents_last_5y": null,
    "crashes_last_5y": null,
    "website": "https://www.aa.com",
    "facebook": "facebook.com/AmericanAirlines",
    "twitter": "twitter.com/americanair",
    "instagram": "instagram.com/americanair",
    "linkedin": "linkedin.com/company/american-airlines",
    "slug": "american-aa-aal-us"
  }
]
```

### Airline logos

FlyStack currently does not document a dedicated logos endpoint in this reference. If you rely on airline logos in your UI, you can typically derive a logo URL from the airline IATA code using your existing assets/CDN strategy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.