# Aircraft Types API
> Resolve and search aircraft type designators — turn the IATA (e.g. 738) and ICAO (e.g. B738) aircraft codes returned by flight-data APIs into readable model names like "Boeing 737-800". Look up by IATA code, ICAO code or name, search 240+ aircraft types, or fetch the whole list. Bundled, fast and always available — a handy companion to flight, airline and airport data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/aircraft-api/..."
```

## Pricing
- **Free** (Free) — 2,000 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 60,000 calls/Mo, 8 req/s
- **Pro** ($14/Mo) — 300,000 calls/Mo, 20 req/s
- **Mega** ($43/Mo) — 1,100,000 calls/Mo, 40 req/s

## Endpoints

### Aircraft

#### `GET /v1/aircraft` — Resolve a type by IATA code, ICAO code or name

**Parameters:**
- `iata` (query, optional, string) — IATA aircraft code, e.g. 738 Example: `738`
- `icao` (query, optional, string) — ICAO aircraft code, e.g. B738
- `name` (query, optional, string) — Model name (alternative)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aircraft-api/v1/aircraft?iata=738"
```

**Response:**
```json
{
    "data": {
        "_hay": "boeing 737-800",
        "iata": "738",
        "icao": "B738",
        "name": "Boeing 737-800"
    },
    "meta": {
        "timestamp": "2026-05-31T01:39:24.119Z",
        "request_id": "ac7da48c-3bb8-4093-b021-9cf1b95b02bd"
    },
    "status": "ok",
    "message": "Aircraft retrieved",
    "success": true
}
```

#### `GET /v1/list` — All aircraft types

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aircraft-api/v1/list"
```

**Response:**
```json
{
    "data": {
        "count": 246,
        "aircraft": [
            {
                "iata": "ND2",
                "icao": "N262",
                "name": "Aerospatiale (Nord) 262"
            },
            {
                "iata": "CRV",
                "icao": "S210",
                "name": "Aerospatiale (Sud Aviation) Se.210 Caravelle"
            },
            {
                "iata": "NDC",
                "icao": "S601",
                "name": "Aerospatiale SN.601 Corvette"
            },
            {
                "iata": "AT4",
                "icao": "AT43",
                "name": "Aerospatiale/Alenia ATR 42-300"
            },
            {
                "iata": "AT5",
                "icao": "AT45",
                "name": "Aerospatiale/Alenia ATR 42-500"
            },
            {
                "iata": "ATR",
                "icao": "AT46",
                "name": "Aerospatiale/Alenia ATR 42-600"
            },
            {
                "iata": "AT7",
                "icao": "AT72",
                "name": "Aerospatiale/Alenia ATR 72"
            },
            {
                "iata": "AB3",
                "icao": "A30B",
                "name": "Airbus A300"
            },
            {
                "iata": "AB6",
                "icao": "A306",
                "name": "Airbus A300-600"
            },
            {
                "iata": "ABB",
                "icao": "A3ST",
                "name": "Airbus A300-600ST Super Transp
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search aircraft types by name

**Parameters:**
- `q` (query, required, string) — Model name (substring) Example: `boeing 777`
- `limit` (query, optional, string) — Max results (1-100, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aircraft-api/v1/search?q=boeing+777&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 7,
        "query": "boeing 777",
        "total": 7,
        "results": [
            {
                "iata": "777",
                "icao": null,
                "name": "Boeing 777"
            },
            {
                "iata": "772",
                "icao": "B772",
                "name": "Boeing 777-200"
            },
            {
                "iata": "77L",
                "icao": "B77L",
                "name": "Boeing 777-200LR"
            },
            {
                "iata": "773",
                "icao": "B773",
                "name": "Boeing 777-300"
            },
            {
                "iata": "77W",
                "icao": "B77W",
                "name": "Boeing 777-300ER"
            },
            {
                "iata": "778",
                "icao": "B778",
                "name": "Boeing 777-8"
            },
            {
                "iata": "779",
                "icao": "B779",
                "name": "Boeing 777-9"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T01:39:24.236Z",
        "request_id": "6833fd2d-af6c-426b-9b1f-a6752ee9b08d"
    },
    "status": "ok",
    "message": "Search completed",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Totals & source

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aircraft-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "total": 246,
        "fields": [
            "name",
            "iata",
            "icao"
        ],
        "source": "OpenFlights aircraft database",
        "with_iata": 234,
        "with_icao": 232
    },
    "meta": {
        "timestamp": "2026-05-31T01:39:24.626Z",
        "request_id": "259f700f-2c68-407f-9754-06a825eeae56"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/aircraft-api
OpenAPI spec: https://www.oanor.com/api/aircraft-api/openapi.json