Plane Finder Flight Track API Documentation Read the track of one leg. Pass the flight_key of a leg from Flight History (for example 5-25480183). The answer lists the track points oldest first: latitude, longitude, altitude in feet, speed in knots, heading in degrees and the time in UTC, with the point count, first_point_utc and last_point_utc, and takeoff_utc and landing_utc. Take-off is the first point with a speed of 60 knots or more above the ground, landing is the last such point. Both are null when the track has no such point. A leg usually has 200 to 300 points. A flight_key that is not known answers 404. Every failed request costs no credit. Cost: 1 credit per successful request.
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.
string
Required
The flight_key of a leg from Flight History, e.g. 5-25480183.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"points": [
{
"id": 0,
"ts": "2025-07-10T09:11:56Z",
"lat": 50.0438,
"lng": 8.55916,
"alt_ft": 0,
"heading": 174,
"speed_kt": 13
},
{
"id": 0,
"ts": "2025-07-10T09:12:56Z",
"lat": 50.0402,
"lng": 8.5601,
"alt_ft": 0,
"heading": 175,
"speed_kt": 18
}
],
"flight_key": "5-25480183",
"landing_utc": "2025-07-10T17:36:10Z",
"point_count": 256,
"takeoff_utc": "2025-07-10T09:31:22Z",
"last_point_utc": "2025-07-10T17:42:49Z",
"first_point_utc": "2025-07-10T09:11:56Z"
},
"meta": {
"source": "planefinder",
"credits": 1,
"billable": true,
"endpoint_family": "flight_track"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"flight_key": [
"The flight_key looks like 5-25480183. Read it from flight-history."
]
},
"message": "The request validation failed"
}Not Found
The flight_key is not known. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "flight_track"
},
"error": {
"code": "NOT_FOUND",
"message": "Plane Finder has no data for this flight."
},
"success": false
}Bad Gateway
Plane Finder answered in a form this API does not read. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "flight_track"
},
"error": {
"code": "PARSER_DRIFT",
"message": "The Plane Finder data is temporarily unavailable. Please retry."
},
"success": false
}Service Unavailable
Plane Finder could not be reached. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "flight_track"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Plane Finder data 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.