# StableTravel FlightAware Flight History

> StableTravel FlightAware Flight History is a paid API for AI agents from stabletravel.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Retrieves historical flight records for a specific flight identifier using FlightAware data, with optional date range and pagination filters.

## Facts

- Endpoint: GET https://stabletravel.dev/api/flightaware/history/flights/id
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stabletravel-flightaware-flight-history-6738c321
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DaeEthZfVvay0pyzd3qpD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stabletravel-flightaware-flight-history-6738c321
```

Example prompt: Pull the flight history for American Airlines flight AA100 from FlightAware — show me all flights that operated between December 1 and December 7, 2026, using the designator ident type.

## When to prefer this

Use this endpoint when you need historical flight records for a known flight identifier — by fa_flight_id, IATA/ICAO designator, or aircraft registration — and want rich structured data including actual vs scheduled times, airport details, and operator info. Prefer this over live flight endpoints when the flight has already occurred and you need archival data. It is ideal for travel analytics, delay analysis, or verifying past itineraries.

## Known failure modes

- Invalid or unknown flight identifier returns empty flights array
- Missing required 'type' or 'method' input fields returns 400 error
- Date range too broad may require pagination via cursor
- Payment not included or insufficient USDC triggers 402 Payment Required
- Unrecognized ident_type enum value causes validation error
- FlightAware upstream unavailable causes 503 or timeout

## How this service works

Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.

## Output

Returns an array of historical flight objects, each containing flight identifier, origin and destination airport details (city, IATA/ICAO codes, name, timezone), flight status, operator codes, aircraft type, flight number, and actual and scheduled departure/arrival times (actual_out, actual_in, scheduled_out, scheduled_in). Also includes pagination links for fetching additional pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "end": {
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "cursor": {
       "type": "string"
      },
      "max_pages": {
       "type": "number"
      },
      "ident_type": {
       "enum": [
        "fa_flight_id",
        "designator",
        "registration"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "flights"
     ],
     "properties": {
      "links": {
       "type": "object",
       "properties": {
        "next": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "flights": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "ident": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "route": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "origin": {
          "anyOf": [
           {
            "type": "object",
            "properties": {
             "city": {
              "anyOf": [
               {
                "type": "string"
               },
               {
                "type": "null"
               }
              
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flights": [
   {
    "type": "Airline",
    "ident": "AAL100",
    "origin": {
     "city": "New York",
     "code": "KJFK",
     "name": "John F. Kennedy International",
     "code_iata": "JFK",
     "code_icao": "KJFK"
    },
    "status": "Arrived",
    "operator": "AAL",
    "actual_in": "2026-12-01T18:55:00Z",
    "actual_out": "2026-12-01T13:05:00Z",
    "ident_iata": "AA100",
    "ident_icao": "AAL100",
    "destination": {
     "city": "Los Angeles",
     "code": "KLAX",
     "name": "Los Angeles International",
     "code_iata": "LAX",
     "code_icao": "KLAX"
    },
    "fa_flight_id": "AAL100-1733068800-airline-0001",
    "scheduled_in": "2026-12-01T19:00:00Z",
    "aircraft_type": "B738",
    "flight_number": "100",
    "operator_iata": "AA",
    "operator_icao": "AAL",
    "scheduled_out": "2026-12-01T13:00:00Z"
   }
  ],
  "num_pages": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stabletravel-flightaware-flight-history-6738c321/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stabletravel.dev](https://www.zero.xyz/host/stabletravel.dev/llms.txt)