Retrieve details for a specific hotel offer via Amadeus GDS, pay-per-request at $0.03 via MPP/x402.
What it does
This endpoint returns full details for a specific hotel offer identified by its offer ID. It is part of the StableTravel platform, which provides pay-per-request access to Amadeus GDS data for flights, hotels, activities, and transfers, plus FlightAware flight tracking. No API keys or subscriptions are required — payment via USDC (on Base, Solana, or Tempo) serves as authentication through the x402/MPP micropayment protocol.
The typical workflow is: list hotels by city or geocode → search offers by hotel IDs → call this endpoint with a specific offerId to confirm room details, pricing, cancellation policies, and availability before booking. The endpoint accepts a GET request with a required `offerId` query parameter and returns a JSON object containing the offer data. The price per call is $0.03 (USD).
StableTravel is operated by Merit Systems and backed by Amadeus for hotel/flight/activity/transfer data and FlightAware AeroAPI for real-time flight tracking. The full OpenAPI 3.1 spec is available at /openapi.json.
Capabilities
Use cases
- —Confirm room type, price, and cancellation policy before booking a hotel
- —Validate a hotel offer is still available after searching offers by hotel ID
- —Retrieve detailed offer data (board type, payment policy, room description) for display to a user
- —Automate hotel booking workflows: list → search → offer → book
Fit
Best for
- —AI travel agents that need to confirm hotel offer details before booking
- —Autonomous agents building multi-step hotel booking pipelines
- —Applications needing real-time hotel pricing without managing API keys
Not for
- —Searching for hotels by location (use /api/hotels/list or /api/hotels/list/by-geocode instead)
- —Booking a hotel (use /api/hotels/book after confirming the offer)
- —Non-programmatic hotel browsing by end users
Quick start
npx agentcash fetch "https://stabletravel.dev/api/hotels/offer?offerId=YOUR_OFFER_ID_HERE"Example
Response
{
"data": {
"type": "hotel-offer",
"hotel": {
"name": "JW Marriott Grosvenor House London",
"hotelId": "MCLONGHM"
},
"offers": [
{
"id": "1",
"room": {
"type": "DELUXE_KING",
"description": "Deluxe King Room, City View"
},
"price": {
"total": "650.00",
"currency": "GBP"
},
"policies": {
"cancellation": {
"deadline": "2025-06-28T23:59:00"
}
},
"checkInDate": "2025-07-01",
"checkOutDate": "2025-07-03"
}
]
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with clear parameter definitions, documented pricing ($0.03/call), live 402 MPP challenge captured, extensive guidance docs, and well-defined workflow context. Only minor gap is lack of a real example response in the spec.
Citations
- —The /api/hotels/offer endpoint costs $0.03 per request (fixed price in USD).https://stabletravel.dev/openapi.json
- —Payment is via USDC on Base, Solana, or Tempo using x402/MPP protocol with no API keys required.https://stabletravel.dev
- —The endpoint requires a single query parameter 'offerId' (string, required).https://stabletravel.dev/openapi.json
- —Typical hotel booking workflow: list → search → offer → book.https://stabletravel.dev/docs
- —StableTravel is operated by Merit Systems and uses Amadeus for hotel data.https://stabletravel.dev