Retrieve a flight order by ID via Amadeus GDS for $0.005 per request, paid with USDC on Tempo.
What it does
This endpoint retrieves an existing flight booking order by its Amadeus order ID. It is part of the StableTravel API suite, which provides pay-per-request access to flights, hotels, activities, transfers (via Amadeus GDS), and real-time flight tracking (via FlightAware AeroAPI). No API keys or subscriptions are required; payment is handled automatically via the MPP/x402 micropayment protocol using USDC on Tempo (chain 4217).
The `/api/flights/orders` endpoint accepts a GET request with a required `id` query parameter (the Amadeus flight order ID). It costs $0.0054 per call. The response returns the full order data including flight offers, traveler details, dictionaries, and any warnings. This endpoint is typically used after booking a flight via the `/api/flights/book` endpoint to confirm or review order details.
StableTravel is operated by Merit Systems and aggregates data from three providers: Amadeus (GDS booking, hotels, activities, transfers), FlightAware (real-time tracking, airport info, history), and Google Flights via SerpAPI (price comparison). The full API covers 70+ endpoints with prices ranging from $0.001 to $0.40 per request. All endpoints support both x402 and MPP payment protocols settling in USDC.
Capabilities
Use cases
- —Retrieve details of a previously booked flight order to display confirmation to a user
- —Verify booking status and traveler information after creating a flight order
- —Build post-booking workflows that need order data for check-in links or itinerary generation
- —Agents autonomously checking order state before cancellation or modification
Fit
Best for
- —AI agents that book and manage flights programmatically
- —Travel automation workflows needing order confirmation after booking
- —Developers building travel apps without managing Amadeus API keys
- —Pay-as-you-go flight order lookups without subscription overhead
Not for
- —Searching or comparing flight prices (use /api/flights/search or /api/google-flights/search instead)
- —Real-time flight tracking or position data (use FlightAware endpoints instead)
- —Bulk retrieval of many orders at once (single-order lookup only)
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flights/orders?id=ORDER_ID_HERE"Example
Response
{
"data": {
"id": "eJzTd9f3NjIJDQYADPcCVQ",
"type": "flight-order",
"travelers": [],
"flightOffers": []
},
"warnings": [],
"dictionaries": {}
}Endpoint
Quality
Full OpenAPI 3.1 schema with clear parameter definitions, pricing info, and payment challenge captured. The endpoint is live (402 MPP challenge confirmed). Docs are comprehensive with workflows and examples, though no example response body is provided for this specific endpoint.
Warnings
- —No example response body provided in the OpenAPI spec for this endpoint; the example_response_json is inferred from the schema structure.
- —The response schema for the 'data' field is untyped (empty schema) — actual Amadeus order structure is not documented in the OpenAPI spec.
Citations
- —The /api/flights/orders endpoint costs $0.005400 per request (fixed price in USD)https://stabletravel.dev/openapi.json
- —Payment is via MPP with method 'tempo' and intent 'charge' using USDC on chain 4217https://stabletravel.dev/openapi.json
- —The endpoint requires a required query parameter 'id' (Flight order ID)https://stabletravel.dev/openapi.json
- —StableTravel provides pay-per-request access to flights, hotels, activities, transfers (Amadeus), and real-time flight tracking (FlightAware AeroAPI)https://stabletravel.dev
- —No API keys needed; payment via USDC on Base, Solana, or Tempo serves as authenticationhttps://stabletravel.dev/openapi.json
- —The endpoint is live, confirmed by 402 MPP challenge responsehttps://stabletravel.dev/api/flights/orders
- —StableTravel is operated by Merit Systemshttps://stabletravel.dev/openapi.json