Look up flights by ident, registration, or fa_flight_id via FlightAware AeroAPI for $0.01/call.
What it does
This endpoint returns flight information for a given identifier — an airline designator (e.g. UAL123), aircraft registration (e.g. N12345), or a FlightAware fa_flight_id. It is part of StableTravel, a pay-per-request travel API suite that wraps FlightAware AeroAPI, Amadeus GDS, and Google Flights behind MPP/x402 micropayments. No API keys or subscriptions are required; payment via USDC on Tempo (chainId 4217) serves as authentication.
The response includes an array of matching flights with fields such as origin/destination airports (ICAO, IATA, city, name), scheduled/estimated/actual gate and runway times, delays, aircraft type, route distance, filed altitude and airspeed, codeshares, gate and terminal info, baggage claim, and flight status with progress percentage. Optional query parameters let you filter by ident_type (fa_flight_id, designator, registration), constrain results to a start/end ISO 8601 time range, and paginate with a cursor. The cost is $0.01 per request. The typical workflow is to call this endpoint first to obtain the fa_flight_id, then use that ID with the /track, /position, /route-info, or /map endpoints for deeper operational data.
The endpoint is live, returning a 402 MPP payment challenge on unauthenticated requests. A full OpenAPI 3.1 schema is published at stabletravel.dev/openapi.json with detailed response types for every field.
Capabilities
Use cases
- —Look up current and recent flights for a given flight number (e.g. UAL123) to get status, delays, and gate info
- —Retrieve flight details by aircraft registration to monitor a specific airframe
- —Obtain the fa_flight_id needed to call track, position, route-info, or map endpoints
- —Build travel-agent workflows that check flight status before booking ground transport
- —Monitor codeshare flights across multiple airline designators
Fit
Best for
- —AI agents that need real-time flight operational data without managing API keys
- —Travel automation pipelines that chain flight lookup → track → map
- —Developers who want pay-per-call FlightAware data without a subscription
Not for
- —Bulk historical analytics requiring thousands of lookups (costs add up at $0.01 each)
- —Use cases needing direct FlightAware push/webhook notifications (this is request-response only)
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/flights/UAL123"Example
Response
{
"links": {
"next": null
},
"flights": [
{
"ident": "UAL123",
"origin": {
"city": "San Francisco",
"code": "KSFO",
"name": "San Francisco Intl",
"code_iata": "SFO"
},
"status": "En Route",
"operator": "UAL",
"actual_out": "2025-06-15T08:12: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-1718000000-schedule-0001",
"registration": "N12345",
"aircraft_type": "B789",
"flight_number": "123",
"operator_iata": "UA",
"scheduled_out": "2025-06-15T08:00:00Z",
"route_distance": 2586,
"progress_percent": 62
}
],
"num_pages": 1
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed response types, clear pricing ($0.01/call), live 402 MPP challenge captured, comprehensive documentation with parameter descriptions and typical workflows. Only minor gap is no inline example responses in the spec itself.
Warnings
- —The MPP challenge decoded amount is 10000 in currency 0x20c000000000000000000000b9537d11c60e8b50 on chainId 4217 (Tempo). The OpenAPI x-payment-info lists $0.01 USD; the base-unit amount likely corresponds to this but the exact token decimals for this Tempo address are not independently confirmed.
- —This is a GET endpoint with a path parameter (:id); the ident is passed as a URL path segment, not a query parameter.
Citations
- —Endpoint price is $0.01 per callhttps://stabletravel.dev/openapi.json
- —Accepts ident_type of fa_flight_id, designator, or registration as query parameterhttps://stabletravel.dev/openapi.json
- —Payment via USDC on Base, Solana, or Tempo; no API keys neededhttps://stabletravel.dev
- —Typical workflow: look up by ident → get fa_flight_id → call /track endpointhttps://stabletravel.dev/openapi.json
- —MPP challenge returned with method=tempo, intent=charge, chainId=4217https://stabletravel.dev/api/flightaware/flights/:id