# ADS-B History Aircraft Day API Documentation

<p><strong>ADS-B History Aircraft Day API Documentation</strong> Get the flight legs of one aircraft on one UTC day. Pass the ICAO hex code (3c65c4) and a date. Each leg has the callsign, takeoff and landing time in UTC, origin and destination airport with the distance to the airport, the duration, the number of trace points and a status. The data comes from the open ADS-B day traces of adsb.lol, made available under the ODbL 1.0. Every answer carries the attribution text and the source name; show it where you show the data. A leg is listed for a date when its takeoff or its landing is on that UTC day, so a flight over midnight appears on both days. status is complete (takeoff and landing seen), incomplete (the trace ends in the air or the takeoff was not seen) or takeoff_before_range (the flight started before the data reaches back; takeoff_utc is null). An airport is named only when it lies within 8 km of the point; otherwise origin or destination is null and the distance to the nearest airport stays in origin_distance_km or destination_distance_km. Add include_track=true for a simplified track of every leg. Positions of aircraft that ask for privacy (LADD or PIA) are hidden: positions_hidden is true and no track is returned. Dates reach back 43 days. An older date answers 422 DATE_OUT_OF_RANGE with the oldest date. Registration and flight number lookups are not part of this endpoint yet. A day without legs answers 200 and costs no credit. Cost: 18 credits per successful request with at least one leg.</p>

- **Documentation:** [https://scrappa.co/docs/adsb-api/adsb_aircraft_history](https://scrappa.co/docs/adsb-api/adsb_aircraft_history)
- **API group:** ADS-B History API
- **Endpoint:** `GET https://scrappa.co/api/adsb/aircraft-history`

## 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 |
| --- | --- | --- | --- |
| `hex` | string | Yes | ICAO 24-bit hex code of the aircraft, 6 hexadecimal characters, e.g. 3c65c4. A registration is not accepted yet. |
| `date` | string | Yes | UTC date YYYY-MM-DD. Today up to 43 days back. An older date answers 422 with the oldest possible date. |
| `include_track` | boolean | No | true adds the simplified track (about one point per minute) to every leg. Default: false. |

## Example response

```json
{
    "data": {
        "hex": "3c65c4",
        "date": "2026-11-07",
        "legs": [
            {
                "origin": {
                    "iata": "MUC",
                    "icao": "EDDM",
                    "name": "Munich Airport",
                    "country": "DE"
                },
                "status": "complete",
                "callsign": "DLH7LM",
                "destination": {
                    "iata": "LHR",
                    "icao": "EGLL",
                    "name": "London Heathrow Airport",
                    "country": "GB"
                },
                "landing_utc": "2026-11-07T12:51:31Z",
                "point_count": 1015,
                "takeoff_utc": "2026-11-07T11:20:51Z",
                "duration_min": 91,
                "origin_distance_km": 0.4,
                "destination_distance_km": 0.5
            }
        ],
        "type": "A20N",
        "count": 1,
        "source": "adsb.lol",
        "attribution": "Contains information from adsb.lol, made available under the ODbL 1.0.",
        "registration": "D-AIND",
        "positions_hidden": false,
        "type_description": "AIRBUS A-320neo"
    },
    "meta": {
        "credits": 18,
        "billable": true,
        "endpoint_family": "aircraft_history"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 422 | Date Out Of Range | The date is older than the 43 days the source keeps. This response is not billable. |
| 503 | Service Unavailable | The day trace could not be read. 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)
