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

# Air

> Aviation reference data: airports, airlines, and aircraft.

The `air` namespace serves aviation reference data: airports, airlines, and aircraft types. It is the lookup data behind flight displays, route maps, and airport pickers.

Air requires the `data:air:read` scope.

```ts theme={null}
import { createVoyantDataClient } from "@voyant-travel/data-sdk";

const client = createVoyantDataClient({ apiKey: process.env.VOYANT_API_KEY! });
```

## Airports

```ts theme={null}
const lhr = await client.air.airports.get("LHR");

const matches = await client.air.airports.search({
  q: "london",
  country: "GB",
});
```

## Airlines and aircraft

```ts theme={null}
const airline = await client.air.airlines.get("BA");
const aircraft = await client.air.aircraft.get("A320");
```

## Types

Key types: `Airport`, `AirportType`, `Airline`, `Aircraft`, `AircraftCategory`. Lookups return `SingleResponse<T>`; searches and lists return `ListResponse<T>`.

<Tip>
  Air provides the reference catalog for aviation. To search and book live flights from suppliers, use the `flights` group in the [Connect SDK](/docs/connect/connect-sdk).
</Tip>