---
type: "firecrawl-provider"
description: "Live flight status: an airport's arrivals and departures, airport delays and cancellation counts, and one flight's status by flight number, including whether it was diverted."
use_when: "An airport's arrivals and departures with their status, its airport-wide delays, and its cancelled, delayed and live flight counts.\n\nOne flight's status by flight number, registration or flight id: times, delay, gates, cancelled or diverted, and where it landed."
categories: "Travel"
capabilities: 9
pricing: "3–42 credits per billed unit; see each capability for its unit and maximum."
---
# FlightAware on Firecrawl Alexandria

Live flight status: an airport's arrivals and departures, airport delays and cancellation counts, and one flight's status by flight number, including whether it was diverted.

- Categories: Travel
- Category index: [Travel category](https://alexandria.firecrawl.dev/agents/categories/travel)
- Provider key: `flightaware`
- Access: Firecrawl credits
- Cost (Recent arrivals): 3 credits per result set
- Cost (Recent departures): 3 credits per result set
- Cost (Expected arrivals): 3 credits per result set
- Cost (Upcoming departures): 3 credits per result set
- Cost (Airport board): 9 credits per result set
- Cost (Airport delays): 5 credits per call
- Cost (Cancellation and delay counts): 9 credits per call
- Cost (Live flight counts): 42 credits per call
- Cost (Flight status): 3 credits per result set

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/flightaware)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/flightaware/openapi.json)

## Capabilities

- [Recent arrivals](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/arrivals): Flights that landed at the airport, newest landing first, under arrivals, with num_pages and next_cursor.
- [Recent departures](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/departures): Flights that departed the airport, newest takeoff first, under departures, with num_pages and next_cursor.
- [Expected arrivals](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/scheduled-arrivals): Flights expected at the airport, soonest estimated landing first, under scheduled_arrivals, with num_pages and next_cursor.
- [Upcoming departures](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/scheduled-departures): Flights due to depart the airport, soonest first, under scheduled_departures, with num_pages and next_cursor.
- [Airport board](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/board): Four lists, scheduled_arrivals, scheduled_departures, arrivals and departures, with num_pages and next_cursor.
- [Airport delays](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/delays): The airport-wide delay in effect, if any. An airport with no delay program answers with an empty reasons list. Single flights can still be late without one.
- [Cancellation and delay counts](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/disruptions): Cancelled, delayed and total scheduled flights for the airport in the period. Diversions are not counted.
- [Live flight counts](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/flight-counts): How many flights are in each live state at the airport. Completed, cancelled and diverted flights are not counted.
- [Flight status](https://alexandria.firecrawl.dev/agents/providers/flightaware/flights/status): Matching flights, newest scheduled departure first, with num_pages and next_cursor. Without a date this is about 14 days of the flight number. A diverted flight has a planned leg, marked diverted and cancelled with no landing time, and usually a second record with the same fa_flight_id for the leg to where it actually landed. A later flight under the same number from that airport is the onward leg.

## 1. Choose this provider when

An airport's arrivals and departures with their status, its airport-wide delays, and its cancelled, delayed and live flight counts.

One flight's status by flight number, registration or flight id: times, delay, gates, cancelled or diverted, and where it landed.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "flightaware",
  "capability": "airports/arrivals",
  "options": {
    "id": "<id>",
    "max_pages": 1
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "flightaware",
    capability: "airports/arrivals",
    options: {
      id: "<id>",
      max_pages: 1,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "flightaware",
  "capability": "airports/arrivals",
  "options": {
    "id": "<id>",
    "max_pages": 1
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "flightaware",
    "capability": "airports/arrivals",
    "options": {
      "id": "<id>",
      "max_pages": 1
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'flightaware/airports/arrivals' \
  --options '{"id":"<id>","max_pages":1}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "flightaware",
  "capability": "airports/arrivals",
  "options": {
    "id": "<id>",
    "max_pages": 1
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "flightaware",
  "capability": "airports/arrivals",
  "options": {
    "id": "<id>",
    "max_pages": 1
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "arrivals": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Recent arrivals

- Capability: `airports/arrivals`
- Description: Flights that landed at the airport, newest landing first, under arrivals, with num_pages and next_cursor.
- Instructions: List flights that have landed at an airport, newest first, with scheduled and actual times, delay and gate. Covers the last 24 hours unless start and end say otherwise. Only flights that landed here are listed: one diverted to another airport is absent, and so is a cancelled one, so this list cannot count the flights diverted away from an airport. A diversion shows only on the flight itself: look the flight number up with flights/status. Flights still on their way are in airports/scheduled-arrivals. 3 Firecrawl credits per result set of up to 15 flights; a query that matches nothing is still one result set.
- Cost: 3 credits per result set
- Capability file: [Recent arrivals](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/arrivals)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "arrivals": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

### Recent departures

- Capability: `airports/departures`
- Description: Flights that departed the airport, newest takeoff first, under departures, with num_pages and next_cursor.
- Instructions: List flights that have taken off from an airport, newest first, with scheduled and actual times, delay, gate, and destination. Covers the last 24 hours unless start and end say otherwise. 3 Firecrawl credits per result set of up to 15 flights; a query that matches nothing is still one result set.
- Cost: 3 credits per result set
- Capability file: [Recent departures](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/departures)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "departures": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

### Expected arrivals

- Capability: `airports/scheduled-arrivals`
- Description: Flights expected at the airport, soonest estimated landing first, under scheduled_arrivals, with num_pages and next_cursor.
- Instructions: List flights expected at an airport, soonest first: not yet departed and en route, with estimated arrival, delay so far and status. Use it for what is inbound or running late right now. 3 Firecrawl credits per result set of up to 15 flights; a query that matches nothing is still one result set.
- Cost: 3 credits per result set
- Capability file: [Expected arrivals](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/scheduled-arrivals)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "scheduled_arrivals": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

### Upcoming departures

- Capability: `airports/scheduled-departures`
- Description: Flights due to depart the airport, soonest first, under scheduled_departures, with num_pages and next_cursor.
- Instructions: List flights due to leave an airport, soonest first, with scheduled and estimated departure, delay, gate and status. 3 Firecrawl credits per result set of up to 15 flights; a query that matches nothing is still one result set.
- Cost: 3 credits per result set
- Capability file: [Upcoming departures](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/scheduled-departures)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "scheduled_departures": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

### Airport board

- Capability: `airports/board`
- Description: Four lists, scheduled_arrivals, scheduled_departures, arrivals and departures, with num_pages and next_cursor.
- Instructions: Read an airport's whole board in one call: recent arrivals, recent departures, expected arrivals and upcoming departures, up to 15 of each per result set. Use one of the four single lists when only one direction matters; they cost less. Like airports/arrivals, it does not show flights diverted away. 9 Firecrawl credits per result set.
- Cost: 9 credits per result set
- Capability file: [Airport board](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/board)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `start` (string): Start of the window, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): End of the window, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `airline` (string): Only this airline's flights, by ICAO or IATA code such as UAL. Not with type. Example: `<airline>`
- `type` (string): Only airline flights or only general aviation. Not with airline. Example: `Airline`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "scheduled_arrivals": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```

### Airport delays

- Capability: `airports/delays`
- Description: The airport-wide delay in effect, if any. An airport with no delay program answers with an empty reasons list. Single flights can still be late without one.
- Instructions: Check whether an airport has an airport-wide delay in effect right now, such as a ground stop or a weather or traffic program, and why. The cheapest answer to how an airport is doing. 5 Firecrawl credits per call.
- Cost: 5 credits per call
- Capability file: [Airport delays](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/delays)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`

Response schema example:
```json
{
  "airport": "<airport>",
  "category": "<category>",
  "color": "<color>",
  "delay_secs": 0,
  "reasons": []
}
```

### Cancellation and delay counts

- Capability: `airports/disruptions`
- Description: Cancelled, delayed and total scheduled flights for the airport in the period. Diversions are not counted.
- Instructions: Count how many of an airport's flights were cancelled or delayed today, yesterday, tomorrow or this week, out of how many were scheduled, in one call. Diversions are not in these counts: look up each flight by number with flights/status. 9 Firecrawl credits per call.
- Cost: 9 credits per call
- Capability file: [Cancellation and delay counts](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/disruptions)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`
- `entity_type` (string, required): origin counts flights leaving the airport; destination counts flights arriving at it. Example: `origin`
- `time_period` (string): Period to count over. Defaults to today. Example: `today`

Response schema example:
```json
{
  "cancellations": 0,
  "delays": 0,
  "total": 0,
  "entity_name": "<entity_name>",
  "entity_id": "<entity_id>"
}
```

### Live flight counts

- Capability: `airports/flight-counts`
- Description: How many flights are in each live state at the airport. Completed, cancelled and diverted flights are not counted.
- Instructions: Count the flights airborne to and from an airport and those still scheduled, right now. The dearest line, at 42 Firecrawl credits per call: use airports/disruptions (9 credits) for cancelled and delayed totals, or airports/delays (5 credits) for how the airport is doing.
- Cost: 42 credits per call
- Capability file: [Live flight counts](https://alexandria.firecrawl.dev/agents/providers/flightaware/airports/flight-counts)

Accepted options:
- `id` (string, required): Airport code. ICAO is preferred (KSFO, EGLL); IATA (SFO) and FAA LID codes also work but can be ambiguous. Example: `<id>`

Response schema example:
```json
{
  "departed": 0,
  "enroute": 0,
  "scheduled_arrivals": 0,
  "scheduled_departures": 0
}
```

### Flight status

- Capability: `flights/status`
- Description: Matching flights, newest scheduled departure first, with num_pages and next_cursor. Without a date this is about 14 days of the flight number. A diverted flight has a planned leg, marked diverted and cancelled with no landing time, and usually a second record with the same fa_flight_id for the leg to where it actually landed. A later flight under the same number from that airport is the onward leg.
- Instructions: Get one flight's status by flight number and date: scheduled, estimated and actual times, delay, gates, cancelled or diverted, and for a diversion the airport it actually landed at. This is the only place a diversion shows: it works one flight at a time, so there is no single call for how many flights into an airport were diverted. Also follows an fa_flight_id from an airport list. 3 Firecrawl credits per result set of up to 15 flights; a query that matches nothing is still one result set.
- Cost: 3 credits per result set
- Capability file: [Flight status](https://alexandria.firecrawl.dev/agents/providers/flightaware/flights/status)

Accepted options:
- `ident` (string, required): Flight number with its airline code, ICAO preferred (UAL1234, or UA1234), an aircraft registration (N123AB), or an fa_flight_id from an earlier result. Example: `<ident>`
- `ident_type` (string): How to read ident when it is ambiguous. designator is a flight number. Example: `designator`
- `date` (string): UTC calendar date of scheduled departure, such as 2026-11-18. Not with start or end. Example: `<date>`
- `start` (string): Earliest scheduled departure, inclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<start>`
- `end` (string): Latest scheduled departure, exclusive. ISO 8601 date or date and time, no more than 10 days back or 2 days ahead. A bare date means 00:00 UTC. Example: `<end>`
- `max_pages` (number): Result sets to fetch in this call, from 1 to 10. One result set is up to 15 flights and is billed on its own. Defaults to 1. Example: `1`
- `cursor` (string): next_cursor from the previous answer, to continue the same list. Omit it for the first page. Example: `<cursor>`

Response schema example:
```json
{
  "flights": [
    {
      "ident": "<ident>",
      "ident_icao": "<ident_icao>",
      "ident_iata": "<ident_iata>",
      "fa_flight_id": "<fa_flight_id>",
      "operator": "<operator>",
      "flight_number": "<flight_number>",
      "registration": "<registration>",
      "status": "<status>",
      "cancelled": false,
      "diverted": false,
      "origin": {},
      "destination": {},
      "departure_delay": 0,
      "arrival_delay": 0,
      "scheduled_out": "<scheduled_out>",
      "scheduled_in": "<scheduled_in>",
      "actual_on": "<actual_on>",
      "progress_percent": 0,
      "aircraft_type": "<aircraft_type>",
      "gate_origin": "<gate_origin>",
      "gate_destination": "<gate_destination>",
      "terminal_origin": "<terminal_origin>",
      "terminal_destination": "<terminal_destination>",
      "baggage_claim": "<baggage_claim>",
      "type": "<type>"
    }
  ]
}
```
