Skip to content
Scrappa Get API key
Plane Finder API 1 credit / request

Plane Finder Flight Track API Documentation

GET https://scrappa.co/api/planefinder/flight-track

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.

Plane Finder Flight Track API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/planefinder/flight-track
Auth header
x-api-key
Cost
1 credit / request
flight_key = example
Response preview
200 OK
{
    "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,
...

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.

flight_key string Required

The flight_key of a leg from Flight History, e.g. 5-25480183.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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.

422

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"
}
404

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
}
502

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
}
503

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.