---
canonical_url: "https://docs.composio.dev/toolkits/aviationstack"
markdown_url: "https://docs.composio.dev/toolkits/aviationstack.md"
product: "platform"
version: null
last_updated: null
---

# AviationStack

AviationStack provides real-time, historical, and scheduled flight data together with global aviation reference catalogs.

- **Category:** lifestyle & entertainment
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `AVIATIONSTACK`
- **Version:** 00000000_00

## Tools

### Get Airport Timetable

**Slug:** `AVIATIONSTACK_GET_AIRPORT_TIMETABLE`

Return the current departure or arrival timetable for one airport, with optional status, airline, flight, terminal, delay, and schedule-time filters. Returns one page and a continuation cursor when more timetable entries are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum timetable entries in this page (1-100 on Free/Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `status` | string ("landed" | "scheduled" | "cancelled" | "active" | "incident" | "diverted" | "redirected" | "unknown") | No | Flight status filter. |
| `direction` | string ("departure" | "arrival") | Yes | Whether to return departures or arrivals. |
| `flight_iata` | string | No | Full IATA flight identifier. |
| `flight_icao` | string | No | Full ICAO flight identifier. |
| `next_cursor` | string | No | Continuation cursor returned by a previous GET_AIRPORT_TIMETABLE call. |
| `airline_iata` | string | No | Airline IATA code filter. |
| `airline_icao` | string | No | Airline ICAO code filter. |
| `airline_name` | string | No | Airline name filter. |
| `flight_number` | string | No | Numeric flight number. |
| `arrival_terminal` | string | No | Arrival terminal filter. |
| `airport_iata_code` | string | Yes | IATA code of the airport whose timetable to return. |
| `departure_terminal` | string | No | Departure terminal filter. |
| `arrival_actual_time` | string | No | Arrival actual-time filter. |
| `departure_actual_time` | string | No | Departure actual-time filter. |
| `minimum_arrival_delay` | integer | No | Minimum arrival delay in minutes. |
| `arrival_estimated_time` | string | No | Arrival estimated-time filter. |
| `arrival_scheduled_time` | string | No | Arrival scheduled-time filter. |
| `minimum_departure_delay` | integer | No | Minimum departure delay in minutes. |
| `departure_estimated_time` | string | No | Departure estimated-time filter. |
| `departure_scheduled_time` | string | No | Departure scheduled-time filter using the provider's documented date-time format. |
| `arrival_actual_runway_time` | string | No | Arrival actual runway-time filter. |
| `departure_actual_runway_time` | string | No | Departure actual runway-time filter. |
| `arrival_estimated_runway_time` | string | No | Arrival estimated runway-time filter. |
| `departure_estimated_runway_time` | string | No | Departure estimated runway-time filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Aircraft Types

**Slug:** `AVIATIONSTACK_LIST_AIRCRAFT_TYPES`

Requires Basic or higher. List aircraft type names and IATA codes, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more aircraft types are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum aircraft types in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_AIRCRAFT_TYPES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Airlines

**Slug:** `AVIATIONSTACK_LIST_AIRLINES`

Requires Basic or higher. List airlines and their codes, status, fleet, hub, and country metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airlines are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum airlines in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_AIRLINES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Airplanes

**Slug:** `AVIATIONSTACK_LIST_AIRPLANES`

Requires Basic or higher. List registered airplanes and aircraft metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airplanes are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum airplanes in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_AIRPLANES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Airports

**Slug:** `AVIATIONSTACK_LIST_AIRPORTS`

Requires Basic or higher. List airports worldwide, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airports are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum airports in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_AIRPORTS call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Cities

**Slug:** `AVIATIONSTACK_LIST_CITIES`

Requires Basic or higher. List destination cities with IATA, country, location, and timezone metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more cities are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum cities in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_CITIES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Countries

**Slug:** `AVIATIONSTACK_LIST_COUNTRIES`

Requires Basic or higher. List destination countries with ISO, population, capital, continent, currency, dialing, and aviation metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more countries are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum countries in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_COUNTRIES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Flights

**Slug:** `AVIATIONSTACK_LIST_FLIGHTS`

List real-time flights, or flights from a specific historical date when flight_date is provided, with filters for route, airline, status, flight identifiers, and delay. Returns one page and a continuation cursor when more matching flights are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum flights in this page (1-100 on Free/Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `flight_date` | string | No | Historical flight date in YYYY-MM-DD format; historical queries require Basic or higher and cover the documented prior 12 months. |
| `flight_iata` | string | No | Full IATA flight identifier, such as AA100. |
| `flight_icao` | string | No | Full ICAO flight identifier. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_FLIGHTS call. |
| `airline_iata` | string | No | Airline IATA code filter. |
| `airline_icao` | string | No | Airline ICAO code filter. |
| `airline_name` | string | No | Airline name filter. |
| `arrival_iata` | string | No | Arrival airport IATA code. |
| `arrival_icao` | string | No | Arrival airport ICAO code. |
| `flight_number` | string | No | Numeric flight number without an airline code. |
| `flight_status` | string ("scheduled" | "active" | "landed" | "cancelled" | "incident" | "diverted") | No | Return only flights with this operational status. |
| `departure_iata` | string | No | Departure airport IATA code. |
| `departure_icao` | string | No | Departure airport ICAO code. |
| `maximum_arrival_delay` | integer | No | Maximum arrival delay in minutes. |
| `minimum_arrival_delay` | integer | No | Minimum arrival delay in minutes. |
| `arrival_scheduled_date` | string | No | Arrival scheduled date in YYYY-MM-DD format. |
| `maximum_departure_delay` | integer | No | Maximum departure delay in minutes. |
| `minimum_departure_delay` | integer | No | Minimum departure delay in minutes. |
| `departure_scheduled_date` | string | No | Departure scheduled date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Future Flights

**Slug:** `AVIATIONSTACK_LIST_FUTURE_FLIGHTS`

List scheduled departures or arrivals for one airport on a specified future date, optionally filtered by airline or flight number. Returns one page and a continuation cursor when more matching flights are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Future flight date in YYYY-MM-DD format. |
| `limit` | integer | No | Maximum future flights in this page (1-100 on Free/Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `direction` | string ("departure" | "arrival") | Yes | Whether to return future departures or arrivals. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_FUTURE_FLIGHTS call. |
| `airline_iata` | string | No | Airline IATA code filter. |
| `airline_icao` | string | No | Airline ICAO code filter. |
| `flight_number` | string | No | Numeric flight number filter. |
| `airport_iata_code` | string | Yes | IATA code of the airport whose future flights to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Routes

**Slug:** `AVIATIONSTACK_LIST_ROUTES`

Requires Basic or higher. List airline route metadata, optionally filtered by flight number, departure or arrival airport, or airline code. Returns one page and a continuation cursor when more matching routes are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum routes in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_ROUTES call; omit for the first page. |
| `airline_iata` | string | No | Airline IATA code. |
| `airline_icao` | string | No | Airline ICAO code. |
| `arrival_iata` | string | No | Arrival airport IATA code. |
| `arrival_icao` | string | No | Arrival airport ICAO code. |
| `flight_number` | string | No | Numeric flight number filter. |
| `departure_iata` | string | No | Departure airport IATA code. |
| `departure_icao` | string | No | Departure airport ICAO code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Aviation Taxes

**Slug:** `AVIATIONSTACK_LIST_TAXES`

Requires Basic or higher. List aviation tax zones and IATA tax codes, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more tax records are available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum tax records in this page (1-100 on Basic; up to 1000 on Professional or higher). |
| `offset` | integer | No | Zero-based result offset for direct page access; use next_cursor to continue a returned page. |
| `search` | string | No | Autocomplete search term; requires Basic or higher. |
| `next_cursor` | string | No | Continuation cursor returned by a previous LIST_TAXES call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
