# FlightAware API: Check flight status

> Checks the public FlightAware status of an airline flight (airline name or code plus number) on a departure date, by default today at the departure airport: airports, scheduled, estimated and actual gate times in local time, delays, gates, terminals, aircraft and distance. A date older than FlightAware's public two-week list is looked up on the flight's history page when FlightAware still shows it.

Unofficial. Not affiliated with or endorsed by FlightAware.

- Page: https://fous.com/methods/flightaware.com/check-flight-status
- Method: `flightaware.com/check_flight_status`, version 1
- Website: flightaware.com
- Returns: flight number, airline, status, origin and destination airports, scheduled/estimated/actual departure and arrival, delays, terminals, gates, aircraft type, route distance, FlightAware link and flight ID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-27"` | Departure date at the departure airport in YYYY-MM-DD, for example 2026-09-28. Defaults to today at that airport. |
| `flight` | string | yes | `"BA 283"` | Airline name or code and flight number, for example United 1234 or BA 283. |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "date": "2026-09-27",
  "flight": "BA 283"
}
```

Its output:

```json
{
  "status": "Landed",
  "airline_name": "British Airways",
  "arrival_gate": "157",
  "aircraft_type": "Boeing 777-300ER",
  "baggage_claim": null,
  "flight_number": "BA283",
  "actual_arrival": "2026-09-27T14:12:00-07:00",
  "departure_gate": "C65",
  "actual_departure": "2026-09-27T10:45:00+01:00",
  "arrival_terminal": "B",
  "flightaware_link": "https://www.flightaware.com/live/flight/BAW283/history/20260927/0940Z/EGLL/KLAX",
  "estimated_arrival": "2026-09-27T14:10:00-07:00",
  "scheduled_arrival": "2026-09-27T13:50:00-07:00",
  "departure_terminal": "5",
  "estimated_departure": "2026-09-27T10:40:00+01:00",
  "origin_airport_code": "LHR",
  "origin_airport_name": "London Heathrow",
  "scheduled_departure": "2026-09-27T10:30:00+01:00",
  "route_distance_miles": 4999,
  "aircraft_registration": null,
  "arrival_delay_minutes": 22,
  "flightaware_flight_id": "BAW283-1790315269-airline-1943p:0",
  "departure_delay_minutes": 15,
  "destination_airport_code": "LAX",
  "destination_airport_name": "Los Angeles Intl"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"flightaware.com/check_flight_status","input":{"date":"2026-09-27","flight":"BA 283"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Is Delta 1782 on time today? I need the departure gate and terminal at the origin airport.
- Check FlightAware for BA 283 departing 2025-03-14 and tell me whether it landed late and by how many minutes.
- My sister is flying Southwest 2406 tomorrow, what's the scheduled arrival time and which aircraft is it?
- Pull up the FlightAware status of Lufthansa LH 456 from last Tuesday, I want to know its actual departure and arrival times.
- What's the current status of AA 100 — estimated arrival, arrival gate, and how far is the route?

## Input schema

```json
{
  "type": "object",
  "required": [
    "flight"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Departure date at the departure airport in YYYY-MM-DD, for example 2026-09-28. Defaults to today at that airport."
    },
    "flight": {
      "type": "string",
      "description": "Airline name or code and flight number, for example United 1234 or BA 283."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "flight_number",
    "airline_name",
    "status",
    "origin_airport_name",
    "origin_airport_code",
    "destination_airport_name",
    "destination_airport_code",
    "scheduled_departure",
    "estimated_departure",
    "actual_departure",
    "scheduled_arrival",
    "estimated_arrival",
    "actual_arrival",
    "departure_delay_minutes",
    "arrival_delay_minutes",
    "departure_terminal",
    "departure_gate",
    "arrival_terminal",
    "arrival_gate",
    "baggage_claim",
    "aircraft_type",
    "route_distance_miles",
    "flightaware_link",
    "aircraft_registration",
    "flightaware_flight_id"
  ],
  "properties": {
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Flight status in plain words."
    },
    "airline_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Airline name."
    },
    "arrival_gate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Arrival gate."
    },
    "aircraft_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Aircraft model in words."
    },
    "baggage_claim": {
      "type": [
        "string",
        "null"
      ],
      "description": "Baggage claim, if displayed."
    },
    "flight_number": {
      "type": "string",
      "description": "Airline flight number, for example UA1234."
    },
    "actual_arrival": {
      "type": [
        "string",
        "null"
      ],
      "description": "Actual gate arrival time, with airport local offset."
    },
    "departure_gate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Departure gate."
    },
    "actual_departure": {
      "type": [
        "string",
        "null"
      ],
      "description": "Actual gate departure time, with airport local offset."
    },
    "arrival_terminal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Arrival terminal."
    },
    "flightaware_link": {
      "type": "string",
      "description": "FlightAware page for this flight."
    },
    "estimated_arrival": {
      "type": [
        "string",
        "null"
      ],
      "description": "Estimated gate arrival time, with airport local offset."
    },
    "scheduled_arrival": {
      "type": [
        "string",
        "null"
      ],
      "description": "Scheduled gate arrival time, with airport local offset."
    },
    "departure_terminal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Departure terminal."
    },
    "estimated_departure": {
      "type": [
        "string",
        "null"
      ],
      "description": "Estimated gate departure time, with airport local offset."
    },
    "origin_airport_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Departure airport IATA code, or ICAO code if IATA is unavailable."
    },
    "origin_airport_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Departure airport name."
    },
    "scheduled_departure": {
      "type": [
        "string",
        "null"
      ],
      "description": "Scheduled gate departure time, with airport local offset."
    },
    "route_distance_miles": {
      "type": [
        "number",
        "null"
      ],
      "description": "Route distance in miles."
    },
    "aircraft_registration": {
      "type": [
        "string",
        "null"
      ],
      "description": "Aircraft registration, if displayed."
    },
    "arrival_delay_minutes": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Minutes late at arrival; negative means early."
    },
    "flightaware_flight_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "FlightAware flight ID."
    },
    "departure_delay_minutes": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Minutes late at departure; negative means early."
    },
    "destination_airport_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Arrival airport IATA code, or ICAO code if IATA is unavailable."
    },
    "destination_airport_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Arrival airport name."
    }
  }
}
```

## See more

- [FlightAware API: Get airport delays](https://fous.com/methods/flightaware.com/get-airport-delays.md): Checks today's delayed and cancelled departures and arrivals at an airport on FlightAware, with current weather and any reported FAA delay status. Delay averages and ground programs are returned only when FlightAware shows them; counts can be null when no statistics row is displayed.
- [FlightAware API: List airport arrivals or departures](https://fous.com/methods/flightaware.com/list-airport-flights.md): Lists the public arrivals or departures FlightAware shows for an airport (name, city, IATA/ICAO code or FlightAware link), with flight times and status. For a city with several airports it picks the busiest listed one and says so; the public board shows up to 20 flights per direction.
- [Flightradar24 API: Check flight status](https://fous.com/methods/flightradar24.com/check-flight-status.md): Checks a flight's public status and times on Flightradar24 by flight number and the departure date at the origin airport.
- [Flightradar24 API: List airport flights](https://fous.com/methods/flightradar24.com/list-airport-flights.md): Lists upcoming departures or arrivals at an airport from the Flightradar24 public airport board, with local times, airline, route, status and aircraft.
- [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
- [FAA API: Get airport delays](https://fous.com/methods/faa.gov/get-airport-delays.md): Gets current FAA delay and closure events for a US airport, found by name, city or code. A city with several airports resolves to one of them, and reported delays may not cover every flight.
- [Expedia API: Search flights](https://fous.com/methods/expedia.com/search-flights.md): Finds Expedia flights between cities or airports on selected dates, with per-traveler USD prices. Round trips combine outbound and return choices; for round trips only the cheapest outbound choices are paired with their returns.
- [TSA Wait Times API: Get security wait time](https://fous.com/methods/tsawaittimes.com/get-security-wait-time.md): Looks up today's crowd-sourced security wait estimate and hourly pattern for a US airport by name, city or code, with PreCheck status and checkpoints.
- [All FlightAware methods](https://fous.com/methods/flightaware.com.md)
