Flightera Route API Documentation Flights of one route across all airlines, with route statistics such as the typical delay and duration. Name both airports with an ICAO or IATA code or a city name. Without a time the latest flights are returned. Add month (back to January 2018) or date with hour (back to March 2018, default hour 12). Each call shows 10 flights. Cost: 1 credit per request. An empty answer is free.
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.
3 optional filters available.
string
Required
Origin airport, ICAO or IATA code or name, e.g. EDDF or FRA.
example
string
Required
Destination airport, ICAO or IATA code or name, e.g. KJFK or JFK.
example
string
Optional
One month, YYYY-MM, from 2018-01.
example
string
Optional
UTC day, YYYY-MM-DD, from 2018-03-01.
2026-06-15
integer
Optional
Hour of the day, 0 to 23, in UTC. Needs date. Defaults to 12.
10
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": 10,
"stats": {
"summary": "On this route, approximately 87% of flights arrive on time. The average delay is 36 minutes.",
"typical_delay": "37min",
"typical_duration": "8h 43min"
},
"origin": {
"city": "Frankfurt",
"iata": "FRA",
"icao": "EDDF"
},
"window": {
"from": "2025-10-15",
"hour": 12
},
"flights": [
{
"date": "2025-10-15",
"status": "landed",
"airline": {
"iata": "LH",
"icao": "DLH",
"name": "Lufthansa",
"country": "Germany"
},
"arrival": {
"gate": "7",
"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-15T23:24:00Z",
"local_date": "2025-10-15",
"actual_local": "2025-10-15T19:24:00-04:00",
"estimated_utc": "2025-10-15T23:16:00Z",
"scheduled_utc": "2025-10-16T00:05:00Z",
"scheduled_local": "2025-10-15T20:05:00-04:00"
},
"aircraft": {
"model": "A340-300",
"state": "Active",
"family": "A340",
"icao24": "3c64f5",
"type_code": "A343",
"manufacturer": "Airbus",
"registration": "D-AIGU"
},
"callsign": "DLH404",
"departure": {
"gate": "Z25",
"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-15T15:36:29Z",
"local_date": "2025-10-15",
"actual_local": "2025-10-15T17:36:29+02:00",
"estimated_utc": null,
"scheduled_utc": "2025-10-15T15:15:00Z",
"scheduled_local": "2025-10-15T17:15:00+02:00"
},
"codeshares": [
"NZ4224",
"SN7232",
"UA8843"
],
"distance_km": 6196,
"delay_minutes": {
"arrival": -41,
"departure": 21
},
"flight_number": "LH404"
}
],
"destination": {
"city": "New York",
"iata": "JFK",
"icao": "KJFK"
}
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "route"
},
"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": {
"origin": [
"The origin 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": "route"
},
"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": "route"
},
"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.