Flightera Flight API Documentation One flight by flight number and UTC departure date. The answer has scheduled, estimated and actual times in UTC and local time, delay minutes, gates, terminals, aircraft with registration, airline and both airports. When a number flies twice on one day, the other flights are in other_legs. A day without a flight answers 200 with flight null and costs nothing. Cost: 1 credit for each page read, usually 2.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
string
Required
Flight number, e.g. LH400 or BA117. A codeshare number follows the operating flight.
example
string
Required
UTC departure day, YYYY-MM-DD. Flights are listed from 2017-09-01.
2026-06-15
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"date": "2025-10-15",
"flight": {
"date": "2025-10-15",
"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-15T16:50:09Z",
"local_date": "2025-10-15",
"actual_local": "2025-10-15T12:50:09-04:00",
"estimated_utc": null,
"scheduled_utc": "2025-10-15T17:20:00Z",
"scheduled_local": "2025-10-15T13:20:00-04:00"
},
"aircraft": {
"model": "B747-400",
"state": "Active",
"family": "B747",
"icao24": "3c4a8c",
"type_code": "B744",
"manufacturer": "Boeing",
"registration": "D-ABTL"
},
"callsign": "DLH400",
"departure": {
"gate": "Z23",
"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-15T09:13:09Z",
"local_date": "2025-10-15",
"actual_local": "2025-10-15T11:13:09+02:00",
"estimated_utc": "2025-10-15T09:03:00Z",
"scheduled_utc": "2025-10-15T08:55:00Z",
"scheduled_local": "2025-10-15T10:55:00+02:00"
},
"codeshares": [
"UA8841",
"ET1610",
"NZ4226",
"SN7230",
"TG7722"
],
"distance_km": 6196,
"delay_minutes": {
"arrival": -30,
"departure": 18
},
"flight_number": "LH400"
},
"other_legs": [],
"flight_number": "LH400",
"requested_flight_number": "LH400"
},
"meta": {
"credits": 2,
"billable": true,
"endpoint_family": "flight"
},
"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"
},
"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"
},
"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.