Flightera Flight History API Documentation Past flights of a flight number back to September 2017. Ask for one UTC departure day with date, a range with from and to (at most 190 days), or one month with month and page. Without a time the current month is returned. Every flight has scheduled, estimated and actual times in UTC and local time, the local date, delay minutes (actual minus scheduled, negative means early), gates, terminals, aircraft with registration, airline, airports with position and distance. The answer also has the number of flights per month and the on-time share of the last 30 days. Flights are listed newest first, 20 per page. An empty answer is free. Cost: 1 credit for each page read.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Flight number, e.g. LH400 or BA117. A codeshare number follows the operating flight.
example
string
Optional
One UTC departure day, YYYY-MM-DD. Flights are listed from 2017-09-01.
2026-06-15
string
Optional
First day of a range, YYYY-MM-DD. The range is at most 190 days.
example
string
Optional
Last day of a range, YYYY-MM-DD. Defaults to today. Needs from.
example
string
Optional
One month, YYYY-MM. Returns 20 flights per page.
example
integer
Optional
Page of a month, 1 to 5. Use next_page of the answer.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"count": 1,
"window": {
"to": "2025-10-31",
"from": "2025-10-31"
},
"flights": [
{
"date": "2025-10-31",
"status": "landed",
"airline": {
"iata": "LH",
"icao": "DLH",
"name": "Lufthansa",
"country": "Germany"
},
"arrival": {
"gate": "8",
"airport": {
"city": "New York",
"iata": "JFK",
"icao": "KJFK",
"name": "John F. Kennedy International Airport",
"country": "United States",
"latitude": 40.63972,
"timezone": "America/New_York",
"longitude": -73.77889,
"country_code": "US"
},
"terminal": "1",
"actual_utc": "2025-10-31T18:53:23Z",
"local_date": "2025-10-31",
"actual_local": "2025-10-31T14:53:23-04:00",
"estimated_utc": null,
"scheduled_utc": "2025-10-31T18:50:00Z",
"scheduled_local": "2025-10-31T14:50:00-04:00"
},
"aircraft": {
"model": "A340-600",
"state": "Active",
"family": "A340",
"icao24": "3c6509",
"type_code": "A346",
"manufacturer": "Airbus",
"registration": "D-AIHI"
},
"callsign": "DLH400",
"departure": {
"gate": "Z68",
"airport": {
"city": "Frankfurt",
"iata": "FRA",
"icao": "EDDF",
"name": "Frankfurt Airport",
"country": "Germany",
"latitude": 50.03333,
"timezone": "Europe/Berlin",
"longitude": 8.57056,
"country_code": "DE"
},
"check_in": "259-335",
"terminal": "1",
"actual_utc": "2025-10-31T10:32:31Z",
"local_date": "2025-10-31",
"actual_local": "2025-10-31T11:32:31+01:00",
"estimated_utc": "2025-10-31T10:15:00Z",
"scheduled_utc": "2025-10-31T10:00:00Z",
"scheduled_local": "2025-10-31T11:00:00+01:00"
},
"codeshares": [
"UA8841",
"ET1610",
"NZ4226",
"SN7230",
"TG7722"
],
"distance_km": 6196,
"delay_minutes": {
"arrival": 3,
"departure": 33
},
"flight_number": "LH400"
}
],
"next_page": null,
"delay_stats": {
"weekly": [
{
"week_start": "2026-05-19",
"on_time_percent": 94,
"median_delay_minutes": 19
},
{
"week_start": "2026-05-26",
"on_time_percent": 94,
"median_delay_minutes": 19
}
],
"flights": 30,
"period_days": 30,
"on_time_percent": 87,
"typical_delay_minutes": -10
},
"flight_number": "LH400",
"flights_per_month": [
{
"month": "2026-11",
"flights": 14
},
{
"month": "2026-10",
"flights": 31
},
{
"month": "2026-09",
"flights": 31
}
],
"requested_flight_number": "LH400"
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "flight_history"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"flight_number": [
"The flight number field is required."
]
},
"message": "The request validation failed"
}Not Found
Flightera has no data for this flight, registration, airport or route. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "flight_history"
},
"error": {
"code": "NOT_FOUND",
"message": "Flightera has no data for this flight, registration, airport or route."
},
"success": false
}Service Unavailable
Flightera could not be reached or changed its answer. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "flight_history"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Flightera source is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.