Resolve a flight ident to its canonical ICAO/IATA/FA identifier via FlightAware for $0.002 per call.
What it does
This endpoint resolves a flight identifier (designator, registration, or FlightAware fa_flight_id) to its canonical form, returning the normalized ident, ident_icao, ident_iata, and fa_flight_id. It is part of the StableTravel API suite, which proxies FlightAware AeroAPI data through a pay-per-request MPP/x402 micropayment layer. No API keys or subscriptions are required; payment via USDC on Tempo (chainId 4217) serves as authentication.
The endpoint accepts a path parameter for the flight ident (e.g., UAL123, N12345, SWA100) and optional query parameters: `ident_type` (fa_flight_id, designator, or registration) and `country_code` for filtering. It returns a JSON object with the canonical identifiers. This is useful as a normalization step before calling other FlightAware endpoints that require a specific ident format.
Pricing is $0.002 per request (2000 base units of pathUSD with 6 decimals on Tempo L2). The endpoint is live, confirmed by a 402 MPP challenge response. The full OpenAPI 3.1 schema is available at stabletravel.dev/openapi.json with complete request/response definitions.
Capabilities
Use cases
- —Normalize a flight number or tail registration to its canonical ICAO/IATA ident before querying tracking or history endpoints
- —Disambiguate codeshare flight numbers to the operating carrier's canonical identifier
- —Convert between FlightAware fa_flight_id, IATA designator, and aircraft registration formats
- —Pre-validate a user-supplied flight ident before making more expensive API calls
Fit
Best for
- —Agents that need to normalize flight identifiers before downstream tracking or booking calls
- —Workflows that accept user-typed flight numbers in various formats
- —Cheap pre-flight-lookup validation step at $0.002 per call
Not for
- —Getting full flight status, position, or track data (use the /flights/{id} or /flights/{id}/track endpoints instead)
- —Searching for flights by route or airline (use /flightaware/flights/search)
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/flights/UAL123/canonical"Example
Response
{
"ident": "UAL123",
"ident_iata": "UA123",
"ident_icao": "UAL123",
"fa_flight_id": "UAL123-1718000000-airline-0001"
}Endpoint
Quality
Full OpenAPI 3.1 schema with response shape, clear pricing ($0.002/call), live 402 MPP challenge confirmed, and comprehensive guidance docs. Slightly below 0.9 because no concrete example response was captured from a live call and the response example above is inferred from the schema.
Warnings
- —The example response JSON is inferred from the OpenAPI schema, not captured from a live call.
- —The path parameter uses :id placeholder syntax; actual calls require substituting the flight ident in the URL path (e.g., /api/flightaware/flights/UAL123/canonical).
Citations
- —Endpoint price is $0.002 per callhttps://stabletravel.dev/openapi.json
- —Payment via USDC on Tempo (chainId 4217), MPP method=tempo, intent=chargehttps://stabletravel.dev/openapi.json
- —Endpoint returns ident, ident_icao, ident_iata, fa_flight_id fieldshttps://stabletravel.dev/openapi.json
- —No API keys needed; payment via USDC on Base, Solana, or Tempo serves as authenticationhttps://stabletravel.dev
- —Endpoint is live (402 MPP challenge captured)https://stabletravel.dev/api/flightaware/flights/:id/canonical
- —Optional query parameters: ident_type (fa_flight_id, designator, registration) and country_codehttps://stabletravel.dev/openapi.json