# Plane Finder Flight Track API Documentation

<p><strong>Plane Finder Flight Track API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/planefinder-api/planefinder_flight_track](https://scrappa.co/docs/planefinder-api/planefinder_flight_track)
- **API group:** Plane Finder API
- **Endpoint:** `GET https://scrappa.co/api/planefinder/flight-track`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `flight_key` | string | Yes | The flight_key of a leg from Flight History, e.g. 5-25480183. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The flight_key is not known. This response is not billable. |
| 502 | Bad Gateway | Plane Finder answered in a form this API does not read. This response is not billable. Retry later. |
| 503 | Service Unavailable | Plane Finder could not be reached. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
