Historical airport arrival data from FlightAware via pay-per-request micropayment — $0.04/call, no API keys.
What it does
This endpoint returns historical flight arrivals for a given airport, sourced from FlightAware's AeroAPI and proxied through StableTravel. You provide an ICAO or IATA airport code as a path parameter (`:id`), and the endpoint returns a paginated list of past arrival flights with details including flight ident (ICAO/IATA), operator, origin/destination airport info, scheduled and actual gate/runway times, delays, aircraft type, route distance, baggage claim, gate, and terminal information.
The endpoint accepts optional query parameters: `airline` (IATA code to filter by carrier), `start` and `end` (ISO 8601 timestamps to bound the time range), `max_pages` (number of pages to fetch), and `cursor` (opaque pagination token). The response includes an `arrivals` array of flight objects, a `links` object with a `next` cursor for pagination, and `num_pages`.
Pricing is $0.04 per request, paid automatically via the MPP protocol using pathUSD on Tempo (chain ID 4217). No API keys, OAuth tokens, or subscriptions are required — payment serves as authentication. The endpoint supports both x402 and MPP settlement protocols. Part of the broader StableTravel API suite covering flights, hotels, activities, transfers, and extensive FlightAware operational data.
Capabilities
Use cases
- —Analyzing on-time performance of arrivals at a specific airport over a date range
- —Building dashboards showing historical traffic patterns at an airport
- —Researching delay trends for flights arriving at a particular hub
- —Auditing airline punctuality for arrivals filtered by carrier
- —Feeding historical arrival data into ML models for delay prediction
Fit
Best for
- —Agents needing historical airport arrival records without managing FlightAware API keys
- —Aviation analytics applications requiring programmatic access to past arrival data
- —Travel research tools that need per-request pricing without subscriptions
Not for
- —Real-time live arrival tracking (use the non-history arrivals endpoint instead)
- —Booking or purchasing flights (use the Amadeus flight endpoints)
- —Bulk historical data dumps requiring millions of records at low cost
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/history/airports/KJFK/flights/arrivals?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z"Example
Response
{
"links": {
"next": null
},
"arrivals": [
{
"ident": "UAL123",
"origin": {
"city": "Los Angeles",
"code": "KLAX",
"name": "Los Angeles Intl",
"code_iata": "LAX"
},
"status": "Arrived",
"operator": "UAL",
"actual_in": "2025-01-01T14:45:00Z",
"ident_iata": "UA123",
"ident_icao": "UAL123",
"destination": {
"city": "New York",
"code": "KJFK",
"name": "John F Kennedy Intl",
"code_iata": "JFK"
},
"fa_flight_id": "UAL123-1735689600-schedule-0001",
"scheduled_in": "2025-01-01T14:30:00Z",
"aircraft_type": "B789",
"arrival_delay": 900,
"operator_iata": "UA",
"route_distance": 2475
}
],
"num_pages": 1
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed response types, clear pricing ($0.04/call), live 402 MPP challenge captured, comprehensive documentation in the guidance field. Slightly below 0.9 because no actual response example was captured from a live call and the endpoint-specific path uses a parameterized :id pattern.
Warnings
- —The MPP challenge decoded amount is 40000 in pathUSD (6 decimals) = $0.04, consistent with documented pricing.
- —No live 200 response was captured; the example response is synthesized from the schema.
Citations
- —Historical airport arrivals endpoint costs $0.04 per requesthttps://stabletravel.dev/openapi.json
- —Endpoint uses MPP method tempo with intent charge on chain ID 4217 (pathUSD)https://stabletravel.dev/openapi.json
- —No API keys needed; payment via USDC on Base, Solana, or Tempo serves as authenticationhttps://stabletravel.dev
- —Data sourced from FlightAware AeroAPIhttps://stabletravel.dev/docs
- —Response schema includes arrivals array with flight details, links for pagination, and num_pageshttps://stabletravel.dev/openapi.json