FLflightaware
history

Get information for a historical flight

Returns historical flight info status summary for a registration, ident, or fa_flight_id. If a fa_flight_id is specified then a maximum of 1 flight is returned, unless the flight has been diverted in which case both the original flight and any diversions will be returned with a duplicate fa_flight_id. If a registraion or ident is specified then a start_date and end_date must be specified. The span between start_date and end_date can be up to 7 days. No more than 40 pages may be requested at once. Data is available from now back to 2011-01-01 00:00:00 UTC.

The field inbound_fa_flight_id will not be populated by this resource.

get/history/flights/{ident}

Request

Path parameters

identstring required

The ident, registration, or fa_flight_id to fetch. If using a flight ident, it is highly recommended to specify ICAO flight ident rather than IATA flight ident to avoid ambiguity and unexpected results. Setting the ident_type can also be used to help disambiguate.

Query parameters

ident_type'designator' | 'registration' | 'fa_flight_id'

Type of ident provided in the ident parameter. By default, the passed ident is interpreted as a registration if possible. This parameter can force the ident to be interpreted as a designator instead.

string date-time
OR
string date

The starting date range for flight results, comparing against flights' scheduled_out field (or scheduled_off if scheduled_out is missing). The format is ISO8601 date or datetime, and the bound is inclusive. Specified start date must occur on or after 2011-01-01 00:00:00 UTC and cannot be in the future. If using date instead of datetime, the time will default to 00:00:00Z.

string date-time
OR
string date

The ending date range for flight results, comparing against flights' scheduled_out field (or scheduled_off if scheduled_out is missing). The format is ISO8601 date or datetime, and the bound is exclusive. Specified end date must occur after 2011-01-01 00:00:00 UTC and cannot be in the future. If using date instead of datetime, the time will default to 00:00:00Z.

max_pagesinteger

Maximum number of pages to fetch. This is an upper limit and not a guarantee of how many pages will be returned.

cursorstring

Opaque value used to get the next batch of data from a paged collection.

Response

OK

num_pagesinteger required

Number of pages returned

Example response

{
  "flights": [
    {
      "origin": {
        "timezone": "America/New_York",
        "name": "LaGuardia",
        "city": "New York"
      },
      "destination": {
        "timezone": "America/New_York",
        "name": "LaGuardia",
        "city": "New York"
      },
      "scheduled_out": "2021-12-31T19:59:59Z",
      "estimated_out": "2021-12-31T19:59:59Z",
      "actual_out": "2021-12-31T19:59:59Z",
      "scheduled_off": "2021-12-31T19:59:59Z",
      "estimated_off": "2021-12-31T19:59:59Z",
      "actual_off": "2021-12-31T19:59:59Z",
      "scheduled_on": "2021-12-31T19:59:59Z",
      "estimated_on": "2021-12-31T19:59:59Z",
      "actual_on": "2021-12-31T19:59:59Z",
      "scheduled_in": "2021-12-31T19:59:59Z",
      "estimated_in": "2021-12-31T19:59:59Z",
      "actual_in": "2021-12-31T19:59:59Z",
      "foresight_predictions_available": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.