---
title: "Get arrived flights"
method: GET
path: "/operators/{id}/flights/arrivals"
tags: ["operators"]
---

# Get arrived flights

`GET /operators/{id}/flights/arrivals`

## Request

- Base URL: `https://aeroapi.flightaware.com/aeroapi`
- URL: `https://aeroapi.flightaware.com/aeroapi/operators/{id}/flights/arrivals`
- Auth: API key in header `x-apikey`
- TypeScript: <https://skmtc.dev/flightaware/apis/aeroapi/docs/operators/:id/flights/arrivals/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns flights for this operator that have departed and subsequently
arrived, ordered by `actual_on` descending. The optional start and end
parameters will be compared against `actual_on` to limit the flights
returned. The start parameter's default value is 24 hours before the
current time. The end parameter's default value is the current time.

## Response `200`

Arrived flights.

- object
  - `links` object, nullable, required: Object containing links to related resources.
    - `next` string, uri-reference, required: A link to the next set of records in a collection.
  - `num_pages` integer, required: Number of pages returned
  - `arrivals` object[], required
    - `ident` string, required: Either the operator code followed by the flight number for the flight (for commercial flights) or the aircraft's registration (for general aviation).
    - `ident_icao` string, nullable: The ICAO operator code followed by the flight number for the flight (for commercial flights)
    - `ident_iata` string, nullable: The IATA operator code followed by the flight number for the flight (for commercial flights)
    - `actual_runway_off` string, nullable: Actual departure runway at origin, when known
    - `actual_runway_on` string, nullable: Actual arrival runway at destination, when known
    - `fa_flight_id` string, required: Unique identifier assigned by FlightAware for this specific flight. If the flight is diverted, the new leg of the flight will have a duplicate fa_flight_id.
    - `operator` string, nullable, required: ICAO code, if exists, of the operator of the flight, otherwise the IATA code
    - `operator_icao` string, nullable: ICAO code of the operator of the flight.
    - `operator_iata` string, nullable, required: IATA code of the operator of the flight.
    - `flight_number` string, nullable, required: Bare flight number of the flight.
    - `registration` string, nullable, required: Aircraft registration (tail number) of the aircraft, when known.
    - `atc_ident` string, nullable, required: The ident of the flight for Air Traffic Control purposes, when known and different than ident.
    - `inbound_fa_flight_id` string, nullable, required: Unique identifier assigned by FlightAware for the previous flight of the aircraft serving this flight.
    - `codeshares` string[], nullable, required: List of any ICAO codeshares operating on this flight.
    - `codeshares_iata` string[], nullable: List of any IATA codeshares operating on this flight.
    - `blocked` boolean, required: Flag indicating whether this flight is blocked from public viewing.
    - `diverted` boolean, required: Flag indicating whether this flight was diverted.
    - `cancelled` boolean, required: Flag indicating that the flight is no longer being tracked by FlightAware. There are a number of reasons this could happen including cancellation by the airline, but that will not always be the case.
    - `position_only` boolean, required: Flag indicating that this flight does not have a flight plan, schedule, or other indication of intent available.
    - `origin` object, nullable, required: Information for this flight's origin airport.
      - `code` string, nullable, required: ICAO/IATA/LID code or string indicating the location where tracking of the flight began/ended for position-only flights.
      - `code_icao` string, nullable: ICAO code
      - `code_iata` string, nullable: IATA code
      - `code_lid` string, nullable: LID code
      - `timezone` string, nullable: Applicable timezone for the airport, in the TZ database format
      - `name` string, nullable: Common name of airport
      - `city` string, nullable: Closest city to the airport
      - `airport_info_url` string, uri-reference, nullable, required: The URL to more information about the airport. Will be null for position-only flights.
    - `destination` object, nullable, required: Information for this flight's destination airport.
      - `code` string, nullable, required: ICAO/IATA/LID code or string indicating the location where tracking of the flight began/ended for position-only flights.
      - `code_icao` string, nullable: ICAO code
      - `code_iata` string, nullable: IATA code
      - `code_lid` string, nullable: LID code
      - `timezone` string, nullable: Applicable timezone for the airport, in the TZ database format
      - `name` string, nullable: Common name of airport
      - `city` string, nullable: Closest city to the airport
      - `airport_info_url` string, uri-reference, nullable, required: The URL to more information about the airport. Will be null for position-only flights.
    - `departure_delay` integer, nullable, required: Departure delay (in seconds) based on either actual or estimated gate departure time. If gate time is unavailable then based on runway departure time. A negative value indicates the flight is early.
    - `arrival_delay` integer, nullable, required: Arrival delay (in seconds) based on either actual or estimated gate arrival time. If gate time is unavailable then based on runway arrival time. A negative value indicates the flight is early.
    - `filed_ete` integer, nullable, required: Runway-to-runway filed duration (seconds).
    - `progress_percent` integer, nullable, required: The percent completion of a flight, based on runway departure/arrival. Null for en route position-only flights.
    - `status` string, required: Human-readable summary of flight status.
    - `aircraft_type` string, nullable, required: Aircraft type will generally be ICAO code, but IATA code will be given when the ICAO code is not known.
    - `route_distance` integer, nullable, required: Planned flight distance (statute miles) based on the filed route. May vary from actual flown distance.
    - `filed_airspeed` integer, nullable, required: Filed IFR airspeed (knots).
    - `filed_altitude` integer, nullable, required: Filed IFR altitude (100s of feet).
    - `route` string, nullable, required: The textual description of the flight's route.
    - `baggage_claim` string, nullable, required: Baggage claim location at the destination airport.
    - `seats_cabin_business` integer, nullable, required: Number of seats in the business class cabin.
    - `seats_cabin_coach` integer, nullable, required: Number of seats in the coach cabin.
    - `seats_cabin_first` integer, nullable, required: Number of seats in the first class cabin.
    - `gate_origin` string, nullable, required: Departure gate at the origin airport.
    - `gate_destination` string, nullable, required: Arrival gate at the destination airport.
    - `terminal_origin` string, nullable, required: Departure terminal at the origin airport.
    - `terminal_destination` string, nullable, required: Arrival terminal at the destination airport.
    - `type` 'General_Aviation' | 'Airline', required: Whether this is a commercial or general aviation flight.
    - `scheduled_out` string, date-time, nullable, required: Scheduled gate departure time.
    - `estimated_out` string, date-time, nullable, required: Estimated gate departure time.
    - `actual_out` string, date-time, nullable, required: Actual gate departure time.
    - `scheduled_off` string, date-time, nullable, required: Scheduled runway departure time.
    - `estimated_off` string, date-time, nullable, required: Estimated runway departure time.
    - `actual_off` string, date-time, nullable, required: Actual runway departure time.
    - `scheduled_on` string, date-time, nullable, required: Scheduled runway arrival time.
    - `estimated_on` string, date-time, nullable, required: Estimated runway arrival time.
    - `actual_on` string, date-time, nullable, required: Actual runway arrival time.
    - `scheduled_in` string, date-time, nullable, required: Scheduled gate arrival time.
    - `estimated_in` string, date-time, nullable, required: Estimated gate arrival time.
    - `actual_in` string, date-time, nullable, required: Actual gate arrival time.

## Other responses

- `400`: Incorrect parameter (id). Id must be a valid operator code and cannot be empty.
- `404`: No such operator exists.

---

[API](https://skmtc.dev/flightaware/apis/aeroapi.md) - [All operations](https://skmtc.dev/flightaware/apis/aeroapi/llms.txt) - [OpenAPI document](https://skmtc.dev/flightaware/apis/aeroapi/revisions/3023e7a0c54c?raw)