# AirLabs Aviation Data API Skill

## Metadata
- name: airlabs
- version: v9
- description: >
    Aviation data API providing real-time flight tracking, airport schedules,
    flight delays, airline and airport databases, aircraft fleets, routes,
    nearby airports, and autocomplete suggestions.
- base_url: https://airlabs.co/api/v9
- auth_type: api_key (query parameter)
- protocol: REST
- format: JSON
- methods: [GET]

---

## Authentication

All requests require the `api_key` query parameter.

| Parameter | Type   | Required | Description          |
|-----------|--------|----------|----------------------|
| api_key   | string | yes      | Your AirLabs API key |

---

## Response Envelope

Every successful response is wrapped:

```json
{
  "request": {
    "lang": "en",
    "currency": "USD",
    "time": 1,
    "id": "...",
    "server": "...",
    "host": "...",
    "pid": 0,
    "key": { ... },
    "params": { ... },
    "version": 9,
    "method": "..."
  },
  "response": [ ... ]
}
```

Error response:

```json
{
  "error": {
    "message": "Error description",
    "code": "error_code"
  }
}
```

---

## Common Query Parameters

Available on most list endpoints:

| Parameter | Type    | Description                                  |
|-----------|---------|----------------------------------------------|
| _fields   | string  | Comma-separated list of response fields      |
| _limit    | integer | Maximum number of results to return          |

---

## Endpoints

---

### 1. Real-Time Flights

```
GET /flights
```

Returns real-time positions and status of flights worldwide.

#### Request Parameters

| Parameter    | Type   | Required | Description                          |
|--------------|--------|----------|--------------------------------------|
| api_key      | string | yes      | API key                              |
| flight_iata  | string | no       | Flight IATA code (e.g. "AA100")      |
| flight_icao  | string | no       | Flight ICAO code (e.g. "AAL100")     |
| airline_iata | string | no       | Airline IATA code (e.g. "AA")        |
| airline_icao | string | no       | Airline ICAO code (e.g. "AAL")       |
| dep_iata     | string | no       | Departure airport IATA (e.g. "JFK")  |
| dep_icao     | string | no       | Departure airport ICAO (e.g. "KJFK") |
| arr_iata     | string | no       | Arrival airport IATA                  |
| arr_icao     | string | no       | Arrival airport ICAO                  |
| flag         | string | no       | Country ISO 2 code (e.g. "US")       |
| hex          | string | no       | ICAO 24-bit address in hex           |
| reg_number   | string | no       | Aircraft registration number          |
| _fields      | string | no       | Comma-separated response fields       |
| _limit       | integer| no       | Limit number of results               |

#### Response Fields

| Field         | Type    | Description                              |
|---------------|---------|------------------------------------------|
| hex           | string  | ICAO 24-bit address (hex)                |
| reg_number    | string  | Aircraft registration number             |
| flag          | string  | Country ISO 2 code                       |
| lat           | float   | Latitude in decimal degrees              |
| lng           | float   | Longitude in decimal degrees             |
| alt           | integer | Altitude in meters                       |
| dir           | float   | Direction / heading in degrees (0-360)   |
| speed         | integer | Horizontal speed in km/h                 |
| v_speed       | float   | Vertical speed in m/s                    |
| squawk        | string  | Transponder squawk code                  |
| flight_number | string  | Flight number                            |
| flight_iata   | string  | Flight IATA code                         |
| flight_icao   | string  | Flight ICAO code                         |
| dep_iata      | string  | Departure airport IATA code              |
| dep_icao      | string  | Departure airport ICAO code              |
| arr_iata      | string  | Arrival airport IATA code                |
| arr_icao      | string  | Arrival airport ICAO code                |
| airline_iata  | string  | Airline IATA code                        |
| airline_icao  | string  | Airline ICAO code                        |
| aircraft_icao | string  | Aircraft ICAO type code                  |
| updated       | integer | Last update Unix timestamp               |
| status        | string  | Flight status (en-route, landed, etc.)   |

#### Example

```
GET https://airlabs.co/api/v9/flights?api_key=API_KEY&dep_iata=JFK&_limit=10
```

---

### 2. Schedules

```
GET /schedules
```

Airport timetable — departures and arrivals schedules.

#### Request Parameters

| Parameter    | Type   | Required | Description                                          |
|--------------|--------|----------|------------------------------------------------------|
| api_key      | string | yes      | API key                                              |
| dep_iata     | string | no       | Departure airport IATA code                          |
| dep_icao     | string | no       | Departure airport ICAO code                          |
| arr_iata     | string | no       | Arrival airport IATA code                            |
| arr_icao     | string | no       | Arrival airport ICAO code                            |
| airline_iata | string | no       | Airline IATA code                                    |
| airline_icao | string | no       | Airline ICAO code                                    |
| flight_iata  | string | no       | Flight IATA code                                     |
| flight_icao  | string | no       | Flight ICAO code                                     |
| flight_number| string | no       | Flight number                                        |
| _fields      | string | no       | Comma-separated response fields                      |
| _limit       | integer| no       | Limit number of results                              |

> **Note:** At least one of `dep_iata`, `dep_icao`, `arr_iata`, or `arr_icao` is required.

#### Response Fields

| Field              | Type    | Description                                   |
|--------------------|---------|-----------------------------------------------|
| airline_iata       | string  | Airline IATA code                             |
| airline_icao       | string  | Airline ICAO code                             |
| flight_iata        | string  | Flight IATA code                              |
| flight_icao        | string  | Flight ICAO code                              |
| flight_number      | string  | Flight number                                 |
| dep_iata           | string  | Departure airport IATA code                   |
| dep_icao           | string  | Departure airport ICAO code                   |
| dep_terminal       | string  | Departure terminal                            |
| dep_gate           | string  | Departure gate                                |
| dep_time           | string  | Scheduled departure time (local)              |
| dep_time_utc       | string  | Scheduled departure time (UTC)                |
| dep_estimated      | string  | Estimated departure time (local)              |
| dep_estimated_utc  | string  | Estimated departure time (UTC)                |
| dep_actual         | string  | Actual departure time (local)                 |
| dep_actual_utc     | string  | Actual departure time (UTC)                   |
| arr_iata           | string  | Arrival airport IATA code                     |
| arr_icao           | string  | Arrival airport ICAO code                     |
| arr_terminal       | string  | Arrival terminal                              |
| arr_gate           | string  | Arrival gate                                  |
| arr_baggage        | string  | Baggage belt / carousel number                |
| arr_time           | string  | Scheduled arrival time (local)                |
| arr_time_utc       | string  | Scheduled arrival time (UTC)                  |
| arr_estimated      | string  | Estimated arrival time (local)                |
| arr_estimated_utc  | string  | Estimated arrival time (UTC)                  |
| arr_actual         | string  | Actual arrival time (local)                   |
| arr_actual_utc     | string  | Actual arrival time (UTC)                     |
| cs_airline_iata    | string  | Codeshare airline IATA code                   |
| cs_flight_iata     | string  | Codeshare flight IATA code                    |
| cs_flight_number   | string  | Codeshare flight number                       |
| status             | string  | Flight status                                 |
| duration           | integer | Scheduled duration in minutes                 |
| delayed            | integer | Delay in minutes                              |
| dep_delayed        | integer | Departure delay in minutes                    |
| arr_delayed        | integer | Arrival delay in minutes                      |

#### Flight Status Values

| Value      | Description         |
|------------|---------------------|
| scheduled  | Scheduled           |
| active     | En-route / Active   |
| landed     | Landed              |
| cancelled  | Cancelled           |
| incident   | Incident            |
| diverted   | Diverted            |
| unknown    | Unknown             |

#### Example

```
GET https://airlabs.co/api/v9/schedules?api_key=API_KEY&dep_iata=LAX&_limit=20
```

---

### 3. Delays

```
GET /delays
```

Returns currently delayed flights.

#### Request Parameters

| Parameter    | Type    | Required | Description                              |
|--------------|---------|----------|------------------------------------------|
| api_key      | string  | yes      | API key                                  |
| dep_iata     | string  | no       | Departure airport IATA code              |
| dep_icao     | string  | no       | Departure airport ICAO code              |
| arr_iata     | string  | no       | Arrival airport IATA code                |
| arr_icao     | string  | no       | Arrival airport ICAO code                |
| airline_iata | string  | no       | Airline IATA code                        |
| airline_icao | string  | no       | Airline ICAO code                        |
| type         | string  | no       | Filter: "departures" or "arrivals"       |
| delay        | integer | no       | Minimum delay in minutes                 |
| _fields      | string  | no       | Comma-separated response fields          |
| _limit       | integer | no       | Limit number of results                  |

#### Response Fields

| Field         | Type    | Description                              |
|---------------|---------|------------------------------------------|
| flight_iata   | string  | Flight IATA code                         |
| flight_icao   | string  | Flight ICAO code                         |
| flight_number | string  | Flight number                            |
| dep_iata      | string  | Departure airport IATA code              |
| dep_icao      | string  | Departure airport ICAO code              |
| arr_iata      | string  | Arrival airport IATA code                |
| arr_icao      | string  | Arrival airport ICAO code                |
| airline_iata  | string  | Airline IATA code                        |
| airline_icao  | string  | Airline ICAO code                        |
| dep_time      | string  | Scheduled departure time (local)         |
| dep_time_utc  | string  | Scheduled departure time (UTC)           |
| arr_time      | string  | Scheduled arrival time (local)           |
| arr_time_utc  | string  | Scheduled arrival time (UTC)             |
| dep_estimated | string  | Estimated departure time (local)         |
| dep_estimated_utc | string | Estimated departure time (UTC)        |
| arr_estimated | string  | Estimated arrival time (local)           |
| arr_estimated_utc | string | Estimated arrival time (UTC)          |
| dep_actual    | string  | Actual departure time (local)            |
| dep_actual_utc| string  | Actual departure time (UTC)              |
| arr_actual    | string  | Actual arrival time (local)              |
| arr_actual_utc| string  | Actual arrival time (UTC)                |
| dep_terminal  | string  | Departure terminal                       |
| dep_gate      | string  | Departure gate                           |
| arr_terminal  | string  | Arrival terminal                         |
| arr_gate      | string  | Arrival gate                             |
| arr_baggage   | string  | Baggage belt / carousel                  |
| delayed       | integer | Delay in minutes                         |
| dep_delayed   | integer | Departure delay in minutes               |
| arr_delayed   | integer | Arrival delay in minutes                 |
| duration      | integer | Scheduled duration in minutes            |
| status        | string  | Flight status                            |

#### Example

```
GET https://airlabs.co/api/v9/delays?api_key=API_KEY&dep_iata=JFK&delay=30
```

---

### 4. Flight (Single Flight Info)

```
GET /flight
```

Returns detailed information about a single flight.

#### Request Parameters

| Parameter   | Type   | Required | Description                                              |
|-------------|--------|----------|----------------------------------------------------------|
| api_key     | string | yes      | API key                                                  |
| flight_iata | string | *        | Flight IATA code (e.g. "AA100")                          |
| flight_icao | string | *        | Flight ICAO code (e.g. "AAL100")                         |

> **Note:** One of `flight_iata` or `flight_icao` is required.

#### Response Fields

| Field              | Type    | Description                              |
|--------------------|---------|------------------------------------------|
| hex                | string  | ICAO 24-bit address (hex)                |
| reg_number         | string  | Aircraft registration number             |
| flag               | string  | Country ISO 2 code                       |
| lat                | float   | Current latitude                         |
| lng                | float   | Current longitude                        |
| alt                | integer | Current altitude in meters               |
| dir                | float   | Direction / heading in degrees           |
| speed              | integer | Horizontal speed in km/h                 |
| v_speed            | float   | Vertical speed in m/s                    |
| squawk             | string  | Transponder squawk code                  |
| flight_number      | string  | Flight number                            |
| flight_iata        | string  | Flight IATA code                         |
| flight_icao        | string  | Flight ICAO code                         |
| airline_iata       | string  | Airline IATA code                        |
| airline_icao       | string  | Airline ICAO code                        |
| aircraft_icao      | string  | Aircraft ICAO type code                  |
| dep_iata           | string  | Departure airport IATA code              |
| dep_icao           | string  | Departure airport ICAO code              |
| dep_terminal       | string  | Departure terminal                       |
| dep_gate           | string  | Departure gate                           |
| dep_time           | string  | Scheduled departure time (local)         |
| dep_time_utc       | string  | Scheduled departure time (UTC)           |
| dep_estimated      | string  | Estimated departure time (local)         |
| dep_estimated_utc  | string  | Estimated departure time (UTC)           |
| dep_actual         | string  | Actual departure time (local)            |
| dep_actual_utc     | string  | Actual departure time (UTC)              |
| arr_iata           | string  | Arrival airport IATA code                |
| arr_icao           | string  | Arrival airport ICAO code                |
| arr_terminal       | string  | Arrival terminal                         |
| arr_gate           | string  | Arrival gate                             |
| arr_baggage        | string  | Baggage belt / carousel                  |
| arr_time           | string  | Scheduled arrival time (local)           |
| arr_time_utc       | string  | Scheduled arrival time (UTC)             |
| arr_estimated      | string  | Estimated arrival time (local)           |
| arr_estimated_utc  | string  | Estimated arrival time (UTC)             |
| arr_actual         | string  | Actual arrival time (local)              |
| arr_actual_utc     | string  | Actual arrival time (UTC)                |
| cs_airline_iata    | string  | Codeshare airline IATA                   |
| cs_flight_iata     | string  | Codeshare flight IATA code               |
| cs_flight_number   | string  | Codeshare flight number                  |
| status             | string  | Flight status                            |
| duration           | integer | Scheduled duration in minutes            |
| delayed            | integer | Delay in minutes                         |
| dep_delayed        | integer | Departure delay in minutes               |
| arr_delayed        | integer | Arrival delay in minutes                 |
| updated            | integer | Last update Unix timestamp               |

#### Example

```
GET https://airlabs.co/api/v9/flight?api_key=API_KEY&flight_iata=AA100
```

---

### 5. Alert

```
GET /alert
```

Flight alert — returns flight details for monitoring status changes, delays, gate changes, etc.

#### Request Parameters

| Parameter   | Type   | Required | Description                                  |
|-------------|--------|----------|----------------------------------------------|
| api_key     | string | yes      | API key                                      |
| flight_iata | string | *        | Flight IATA code                             |
| flight_icao | string | *        | Flight ICAO code                             |

> **Note:** One of `flight_iata` or `flight_icao` is required.

#### Response Fields

Same structure as the [Flight](#4-flight-single-flight-info) endpoint response.

#### Example

```
GET https://airlabs.co/api/v9/alert?api_key=API_KEY&flight_iata=AA100
```

---

### 6. Nearby

```
GET /nearby
```

Returns airports near the specified geographic coordinates.

#### Request Parameters

| Parameter | Type    | Required | Description                        |
|-----------|---------|----------|------------------------------------|
| api_key   | string  | yes      | API key                            |
| lat       | float   | yes      | Latitude in decimal degrees        |
| lng       | float   | yes      | Longitude in decimal degrees       |
| distance  | integer | no       | Radius distance in km (default 100)|
| _fields   | string  | no       | Comma-separated response fields    |
| _limit    | integer | no       | Limit number of results            |

#### Response Fields

| Field        | Type    | Description                        |
|--------------|---------|------------------------------------|
| name         | string  | Airport name                       |
| iata_code    | string  | Airport IATA code                  |
| icao_code    | string  | Airport ICAO code                  |
| lat          | float   | Airport latitude                   |
| lng          | float   | Airport longitude                  |
| alt          | integer | Airport elevation in meters        |
| city         | string  | City name                          |
| city_code    | string  | City IATA code                     |
| country_code | string  | Country ISO 2 code                 |
| country      | string  | Country name                       |
| timezone     | string  | Timezone (tz database name)        |
| distance     | float   | Distance from provided coordinates (km) |

#### Example

```
GET https://airlabs.co/api/v9/nearby?api_key=API_KEY&lat=40.6413&lng=-73.7781&distance=50
```

---

### 7. Suggest

```
GET /suggest
```

Autocomplete / search suggestions for airports, cities, and airlines.

#### Request Parameters

| Parameter | Type   | Required | Description                  |
|-----------|--------|----------|------------------------------|
| api_key   | string | yes      | API key                      |
| search    | string | yes      | Search query (min 2 chars)   |
| _fields   | string | no       | Comma-separated response fields |
| _limit    | integer| no       | Limit number of results      |

#### Response Fields

Response returns separate arrays grouped by type:

**airports** array:

| Field        | Type   | Description               |
|--------------|--------|---------------------------|
| name         | string | Airport name              |
| iata_code    | string | Airport IATA code         |
| icao_code    | string | Airport ICAO code         |
| city         | string | City name                 |
| city_code    | string | City IATA code            |
| country_code | string | Country ISO 2 code        |
| country      | string | Country name              |
| lat          | float  | Latitude                  |
| lng          | float  | Longitude                 |

**cities** array:

| Field        | Type   | Description               |
|--------------|--------|---------------------------|
| name         | string | City name                 |
| city_code    | string | City IATA code            |
| country_code | string | Country ISO 2 code        |
| country      | string | Country name              |
| lat          | float  | Latitude                  |
| lng          | float  | Longitude                 |

**airlines** array:

| Field     | Type   | Description               |
|-----------|--------|---------------------------|
| name      | string | Airline name              |
| iata_code | string | Airline IATA code         |
| icao_code | string | Airline ICAO code         |

#### Example

```
GET https://airlabs.co/api/v9/suggest?api_key=API_KEY&search=new+york
```

---

### 8. Airlines

```
GET /airlines
```

Airlines database.

#### Request Parameters

| Parameter    | Type   | Required | Description                     |
|--------------|--------|----------|---------------------------------|
| api_key      | string | yes      | API key                         |
| iata_code    | string | no       | Airline IATA code (e.g. "AA")   |
| icao_code    | string | no       | Airline ICAO code (e.g. "AAL")  |
| airline_iata | string | no       | Alias for iata_code             |
| airline_icao | string | no       | Alias for icao_code             |
| _fields      | string | no       | Comma-separated response fields |
| _limit       | integer| no       | Limit number of results         |

#### Response Fields

| Field              | Type    | Description                              |
|--------------------|---------|------------------------------------------|
| name               | string  | Airline name                             |
| iata_code          | string  | Airline IATA code                        |
| icao_code          | string  | Airline ICAO code                        |
| iata_prefix        | string  | IATA accounting prefix                   |
| iata_accounting    | string  | IATA accounting code                     |
| callsign           | string  | Airline callsign                         |
| country_code       | string  | Country ISO 2 code                       |
| hub_code           | string  | Main hub airport IATA code               |
| fleet_size         | integer | Total fleet size                         |
| fleet_average_age  | float   | Average fleet age in years               |
| date_founded       | string  | Year founded                             |
| date_active        | string  | Date airline became active               |
| status             | string  | Airline status (active, etc.)            |
| type               | string  | Airline type (scheduled, charter, cargo) |

#### Example

```
GET https://airlabs.co/api/v9/airlines?api_key=API_KEY&iata_code=AA
```

---

### 9. Airports

```
GET /airports
```

Airports database.

#### Request Parameters

| Parameter    | Type   | Required | Description                          |
|--------------|--------|----------|--------------------------------------|
| api_key      | string | yes      | API key                              |
| iata_code    | string | no       | Airport IATA code (e.g. "JFK")      |
| icao_code    | string | no       | Airport ICAO code (e.g. "KJFK")     |
| airport_iata | string | no       | Alias for iata_code                  |
| airport_icao | string | no       | Alias for icao_code                  |
| city_code    | string | no       | City IATA code                       |
| country_code | string | no       | Country ISO 2 code                   |
| _fields      | string | no       | Comma-separated response fields      |
| _limit       | integer| no       | Limit number of results              |

#### Response Fields

| Field         | Type    | Description                             |
|---------------|---------|-----------------------------------------|
| name          | string  | Airport name                            |
| iata_code     | string  | Airport IATA code                       |
| icao_code     | string  | Airport ICAO code                       |
| lat           | float   | Latitude in decimal degrees             |
| lng           | float   | Longitude in decimal degrees            |
| alt           | integer | Elevation in meters                     |
| city          | string  | City name                               |
| city_code     | string  | City IATA code                          |
| un_locode     | string  | UN/LOCODE                               |
| timezone      | string  | Timezone (tz database name)             |
| country_code  | string  | Country ISO 2 code                      |
| phone         | string  | Airport phone number                    |
| website       | string  | Airport website URL                     |
| popularity    | integer | Popularity rank                         |
| is_major      | boolean | Whether this is a major airport         |
| slug          | string  | URL-friendly slug                       |

#### Example

```
GET https://airlabs.co/api/v9/airports?api_key=API_KEY&iata_code=JFK
```

---

### 10. Cities

```
GET /cities
```

Cities database.

#### Request Parameters

| Parameter    | Type   | Required | Description                          |
|--------------|--------|----------|--------------------------------------|
| api_key      | string | yes      | API key                              |
| city_code    | string | no       | City IATA code                       |
| country_code | string | no       | Country ISO 2 code                   |
| _fields      | string | no       | Comma-separated response fields      |
| _limit       | integer| no       | Limit number of results              |

#### Response Fields

| Field        | Type   | Description                        |
|--------------|--------|------------------------------------|
| name         | string | City name                          |
| city_code    | string | City IATA code                     |
| lat          | float  | Latitude in decimal degrees        |
| lng          | float  | Longitude in decimal degrees       |
| country_code | string | Country ISO 2 code                 |
| timezone     | string | Timezone (tz database name)        |
| un_locode    | string | UN/LOCODE                          |
| popularity   | integer| Popularity rank                    |

#### Example

```
GET https://airlabs.co/api/v9/cities?api_key=API_KEY&country_code=US&_limit=10
```

---

### 11. Fleets

```
GET /fleets
```

Aircraft fleets database.

#### Request Parameters

| Parameter    | Type   | Required | Description                        |
|--------------|--------|----------|------------------------------------|
| api_key      | string | yes      | API key                            |
| airline_iata | string | no       | Airline IATA code                  |
| airline_icao | string | no       | Airline ICAO code                  |
| reg_number   | string | no       | Aircraft registration number       |
| hex          | string | no       | ICAO 24-bit address (hex)          |
| flag         | string | no       | Country ISO 2 code                 |
| _fields      | string | no       | Comma-separated response fields    |
| _limit       | integer| no       | Limit number of results            |

> **Note:** At least one filter parameter is recommended.

#### Response Fields

| Field            | Type    | Description                            |
|------------------|---------|----------------------------------------|
| hex              | string  | ICAO 24-bit address (hex)              |
| reg_number       | string  | Aircraft registration number           |
| flag             | string  | Country ISO 2 code                     |
| airline_iata     | string  | Airline IATA code                      |
| airline_icao     | string  | Airline ICAO code                      |
| aircraft_iata    | string  | Aircraft IATA type code                |
| aircraft_icao    | string  | Aircraft ICAO type code                |
| model            | string  | Aircraft model name                    |
| manufacturer     | string  | Aircraft manufacturer                  |
| built_year       | integer | Year of manufacture                    |
| first_flight_date| string  | Date of first flight (YYYY-MM-DD)      |
| engines_count    | integer | Number of engines                      |
| engines_type     | string  | Engine type (jet, turboprop, piston)   |
| plane_age        | float   | Aircraft age in years                  |
| plane_owner      | string  | Aircraft owner                         |
| plane_status     | string  | Aircraft status (active, stored, etc.) |
| msn              | string  | Manufacturer serial number             |
| line_number      | string  | Production line number                 |
| num_seats        | integer | Number of seats                        |
| rollout_date     | string  | Rollout date (YYYY-MM-DD)             |
| delivery_date    | string  | Delivery date (YYYY-MM-DD)            |

#### Example

```
GET https://airlabs.co/api/v9/fleets?api_key=API_KEY&airline_iata=AA&_limit=10
```

---

### 12. Routes

```
GET /routes
```

Flight routes database.

#### Request Parameters

| Parameter    | Type   | Required | Description                        |
|--------------|--------|----------|------------------------------------|
| api_key      | string | yes      | API key                            |
| dep_iata     | string | no       | Departure airport IATA code        |
| dep_icao     | string | no       | Departure airport ICAO code        |
| arr_iata     | string | no       | Arrival airport IATA code          |
| arr_icao     | string | no       | Arrival airport ICAO code          |
| airline_iata | string | no       | Airline IATA code                  |
| airline_icao | string | no       | Airline ICAO code                  |
| flight_iata  | string | no       | Flight IATA code                   |
| flight_icao  | string | no       | Flight ICAO code                   |
| _fields      | string | no       | Comma-separated response fields    |
| _limit       | integer| no       | Limit number of results            |

> **Note:** At least one filter parameter is recommended.

#### Response Fields

| Field            | Type    | Description                               |
|------------------|---------|-------------------------------------------|
| airline_iata     | string  | Airline IATA code                         |
| airline_icao     | string  | Airline ICAO code                         |
| flight_number    | string  | Flight number                             |
| flight_iata      | string  | Flight IATA code                          |
| flight_icao      | string  | Flight ICAO code                          |
| dep_iata         | string  | Departure airport IATA code               |
| dep_icao         | string  | Departure airport ICAO code               |
| dep_terminal     | string  | Departure terminal                        |
| dep_time         | string  | Scheduled departure time (local)          |
| dep_time_utc     | string  | Scheduled departure time (UTC)            |
| arr_iata         | string  | Arrival airport IATA code                 |
| arr_icao         | string  | Arrival airport ICAO code                 |
| arr_terminal     | string  | Arrival terminal                          |
| arr_time         | string  | Scheduled arrival time (local)            |
| arr_time_utc     | string  | Scheduled arrival time (UTC)              |
| duration         | integer | Flight duration in minutes                |
| days             | array   | Days of week the route operates           |
| cs_airline_iata  | string  | Codeshare airline IATA code               |
| cs_flight_number | string  | Codeshare flight number                   |
| cs_flight_iata   | string  | Codeshare flight IATA code                |

#### Example

```
GET https://airlabs.co/api/v9/routes?api_key=API_KEY&dep_iata=JFK&arr_iata=LAX
```

---

## Time Format

All datetime strings follow the format:

```
YYYY-MM-DD HH:MM
```

- Fields without `_utc` suffix are in **local airport time**
- Fields with `_utc` suffix are in **UTC**

---

## Rate Limits & Plans

Rate limits depend on your API plan. Check your dashboard at https://airlabs.co for current usage and limits.

---

## Error Codes

| Code                | Description                          |
|---------------------|--------------------------------------|
| api_key_required    | API key is missing                   |
| unknown_api_key     | Invalid or unknown API key           |
| usage_limit_reached | Rate limit or plan limit exceeded    |
| wrong_params        | Invalid or missing parameters        |
| no_data             | No data available for the request    |