Book a hotel offer via Amadeus GDS for $0.002 per request, paid with USDC micropayments.
What it does
This endpoint creates a hotel booking order through the Amadeus Global Distribution System. It is part of StableTravel, a pay-per-request travel API suite covering flights, hotels, activities, transfers, and real-time flight tracking (via FlightAware AeroAPI). No API keys or subscriptions are required; payment is handled automatically via the x402/MPP micropayment protocol using USDC on Base, Solana, or Tempo.
The /api/hotels/book endpoint accepts a POST request with a JSON body containing guest details (name, email, phone, frequent traveler info), room associations, travel agent contact information, and optional payment and arrival information. The body must wrap everything in a `data` object with `type` set to `"hotel-order"`. The typical workflow is: list hotels by city or geocode → search for offers by hotel IDs → confirm offer details → book. Each step in the pipeline costs between $0.002 and $0.03 per call.
The endpoint costs $0.002 per request (fixed price in USD). It supports both x402 and MPP (Tempo method, charge intent) settlement protocols. The OpenAPI schema is fully documented at /openapi.json with request body schema, response structure, and all sibling hotel endpoints.
Capabilities
Use cases
- —AI agent autonomously books a hotel room after comparing offers
- —Travel planning workflow that searches, prices, and books hotels end-to-end
- —Automated corporate travel system that reserves hotels without manual credential management
- —Chatbot completes hotel reservation on behalf of a user with USDC micropayment
Fit
Best for
- —AI agents that need programmatic hotel booking without API key setup
- —Developers building travel automation with pay-per-use pricing
- —Workflows that chain hotel list → search → offer → book in a single pipeline
Not for
- —High-volume batch hotel booking requiring negotiated enterprise rates
- —Applications that need to modify or amend existing hotel reservations (no amendment endpoint documented)
- —Users who cannot pay via USDC on Base, Solana, or Tempo
Quick start
npx agentcash fetch -X POST -H "Content-Type: application/json" \
-d '{"data":{"type":"hotel-order","guests":[{"tid":1,"firstName":"John","lastName":"Doe","email":"john@example.com","phone":"+1234567890"}],"travelAgent":{"contact":{"email":"agent@example.com"}}}}' \
"https://stabletravel.dev/api/hotels/book"Example
Request
{
"data": {
"type": "hotel-order",
"guests": [
{
"tid": 1,
"email": "jane.smith@example.com",
"phone": "+14155551234",
"title": "MS",
"lastName": "Smith",
"firstName": "Jane"
}
],
"travelAgent": {
"contact": {
"email": "agent@travelco.com"
}
}
}
}Response
{
"data": {
"id": "XD_12345678",
"type": "hotel-order",
"hotelBookings": [
{
"id": "1",
"type": "hotel-booking",
"bookingStatus": "CONFIRMED"
}
]
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with request body, response structure, and clear pricing ($0.002/request). Endpoint is POST-only so the probe's HEAD/GET returning 405 is expected, not a liveness failure. Docs and guidance are thorough. Minor deduction: no actual 402 challenge was captured for this specific endpoint, and the example response is inferred from Amadeus patterns rather than a live sample.
Warnings
- —Probe returned 405 on HEAD and GET because this is a POST-only endpoint; this does not indicate the endpoint is down.
- —No actual 402 MPP challenge was captured for this specific endpoint during probing.
- —The example response is inferred from the schema and Amadeus conventions, not from a live API call.
- —Room associations and offer IDs are required for a real booking but not enforced in the schema's required fields — callers must obtain an offerId from the /hotels/offer endpoint first.
Citations
- —Hotel booking endpoint costs $0.002 per request (USD, fixed mode)https://stabletravel.dev/openapi.json
- —Request body requires data.type = 'hotel-order', data.guests array, and data.travelAgent with contact emailhttps://stabletravel.dev/openapi.json
- —Typical hotel booking workflow: list → search → offer → bookhttps://stabletravel.dev/openapi.json
- —No API keys needed; payment via USDC on Base, Solana, or Tempo serves as authenticationhttps://stabletravel.dev
- —Supports both x402 and MPP (method: tempo, intent: charge) payment protocolshttps://stabletravel.dev/openapi.json