Confirm real-time pricing for an Amadeus flight offer at $0.03 per request via MPP micropayment.
What it does
The `/api/flights/price` endpoint on StableTravel confirms pricing for a flight offer previously retrieved from the `/api/flights/search` endpoint. It accepts a POST request with a JSON body containing the full flight offer object wrapped in a `data` object with `type: "flight-offers-pricing"`. The endpoint returns confirmed pricing details including updated fare breakdowns, taxes, and availability from the Amadeus GDS. This is a critical step in the search → price → book workflow for programmatic flight booking.
This endpoint is part of the broader StableTravel API platform, which provides pay-per-request access to flights, hotels, activities, transfers (via Amadeus), real-time flight tracking (via FlightAware AeroAPI), and Google Flights price comparison. No API keys or subscriptions are required — payment is handled automatically via the x402/MPP protocol using USDC on Base, Solana, or Tempo. The price confirmation call costs $0.03 (listed as $0.032400 in the OpenAPI spec). The endpoint supports both x402 and MPP (method: tempo, intent: charge) settlement protocols.
The typical workflow is: search flights via GET or POST `/api/flights/search` ($0.05), confirm pricing via POST `/api/flights/price` ($0.03), then book via POST `/api/flights/book` ($0.09). The price confirmation step validates that the fare is still available and returns the exact amount the traveler would pay, which may differ from the initial search result due to fare class availability changes.
Capabilities
Use cases
- —Confirm the exact fare and taxes for a flight offer before booking
- —Validate that a searched flight offer is still available at the quoted price
- —Build an automated search → price → book pipeline for flight reservations
- —Let an AI agent verify pricing before committing to a flight purchase
- —Compare confirmed prices across multiple flight offers from a search
Fit
Best for
- —AI agents that need to programmatically book flights through a search-price-book workflow
- —Developers building travel booking automation without managing Amadeus API keys
- —Applications that need real-time GDS fare confirmation before creating orders
Not for
- —Price comparison across airlines and OTAs (use /api/google-flights/search instead)
- —Retrieving flight schedules or status without booking intent
- —Hotel, activity, or transfer pricing
Quick start
# 1. Search flights first, then confirm pricing with the returned offer
npx agentcash fetch -X POST \
-H "Content-Type: application/json" \
-d '{"data":{"type":"flight-offers-pricing","flightOffers":[<flight-offer-from-search>]}}' \
"https://stabletravel.dev/api/flights/price"Example
Request
{
"data": {
"type": "flight-offers-pricing",
"flightOffers": [
{
"id": "1",
"type": "flight-offer",
"source": "GDS",
"itineraries": [
{
"segments": [
{
"number": "1",
"arrival": {
"at": "2025-06-15T11:30:00",
"iataCode": "LAX"
},
"departure": {
"at": "2025-06-15T08:00:00",
"iataCode": "JFK"
},
"carrierCode": "AA"
}
]
}
]
}
]
}
}Response
{
"data": {
"type": "flight-offers-pricing",
"flightOffers": [
{
"id": "1",
"type": "flight-offer",
"price": {
"base": "210.00",
"fees": [
{
"type": "SUPPLIER",
"amount": "0.00"
}
],
"total": "245.50",
"currency": "USD",
"grandTotal": "245.50"
},
"source": "GDS",
"pricingOptions": {
"fareType": [
"PUBLISHED"
],
"includedCheckedBagsOnly": true
}
}
]
},
"dictionaries": {}
}Endpoint
Quality
Full OpenAPI 3.1 schema with request/response definitions, clear pricing ($0.032400 USD), detailed guidance documentation, and well-documented workflow. The endpoint returned 405 on HEAD/GET probes which is expected since it's POST-only; the OpenAPI spec confirms it's a POST endpoint with a 402 payment challenge. No live 402 was captured for this specific endpoint but the broader platform is clearly operational.
Warnings
- —Probe returned 405 on HEAD and GET because this is a POST-only endpoint; no direct 402 challenge was captured for this specific path
- —The request body requires a full flight offer object from a prior /api/flights/search call — it cannot be used standalone
- —Example request/response are illustrative based on the OpenAPI schema; actual Amadeus GDS responses contain significantly more nested data
Citations
- —The /api/flights/price endpoint costs $0.032400 USD per requesthttps://stabletravel.dev/openapi.json
- —The endpoint accepts POST with type flight-offers-pricing and flightOffers arrayhttps://stabletravel.dev/openapi.json
- —Payment is via USDC on Base, Solana, or Tempo using x402/MPP protocol with no API keys neededhttps://stabletravel.dev
- —The typical workflow is search → price → bookhttps://stabletravel.dev/openapi.json
- —StableTravel is powered by Amadeus GDS and FlightAware AeroAPIhttps://stabletravel.dev