Search hotel offers for a specific hotel by Amadeus ID, pay $0.03 per request via MPP/x402.
What it does
This endpoint searches available hotel offers for a specific hotel identified by its Amadeus hotel ID. It is part of the StableTravel API, which provides pay-per-request access to travel data from Amadeus and FlightAware without API keys or subscriptions. Payment is handled via the MPP (Tempo) or x402 protocol using USDC.
The endpoint accepts a required `hotelId` parameter along with optional filters for check-in/check-out dates, number of adults, currency, board type (room only, breakfast, half board, full board, all-inclusive), payment policy, price range, and language. It returns hotel offer data from the Amadeus GDS. The typical workflow is: first use `/api/hotels/list` or `/api/hotels/list/by-geocode` to discover hotel IDs, then call this endpoint to retrieve available offers for a specific property.
Priced at $0.032 per request, the endpoint settles payments on Tempo (chainId 4217) in pathUSD. The response includes offer details that can subsequently be passed to `/api/hotels/offer` for full details or `/api/hotels/book` to complete a reservation. No authentication tokens or API keys are required — the micropayment itself serves as authentication.
Capabilities
Use cases
- —Retrieve available room offers and rates for a known hotel before booking
- —Compare pricing across dates for a specific property
- —Build a hotel booking flow: list → search by hotel → offer details → book
- —Filter hotel offers by board type or payment policy for a travel agent workflow
- —Programmatically check hotel availability for autonomous travel planning agents
Fit
Best for
- —AI agents that need to look up hotel offers without managing API keys
- —Travel automation pipelines that already have an Amadeus hotel ID
- —Developers who want per-request hotel data without subscription commitments
Not for
- —Searching hotels by location or city (use /api/hotels/list or /api/hotels/list/by-geocode instead)
- —Bulk hotel inventory downloads requiring thousands of requests per second
- —Users who need free hotel data without micropayment capability
Quick start
npx agentcash fetch "https://stabletravel.dev/api/hotels/search/by-hotel?hotelId=MCLONGHM&checkInDate=2025-07-01&checkOutDate=2025-07-03&adults=2"Example
Response
{
"data": {
"type": "hotel-offers",
"hotel": {
"name": "Example Hotel London",
"hotelId": "MCLONGHM"
},
"offers": [
{
"id": "ABC123",
"room": {
"type": "DOUBLE",
"description": "Standard Double Room"
},
"price": {
"total": "250.00",
"currency": "USD"
},
"checkInDate": "2025-07-01",
"checkOutDate": "2025-07-03"
}
]
}
}Endpoint
Quality
Full OpenAPI schema with detailed parameters, clear pricing ($0.032/request), live 402 MPP challenge captured, and comprehensive documentation including workflows. Response schema is minimal (generic `data` object) but the endpoint behavior is well-documented in guidance text.
Warnings
- —Response schema for this endpoint is loosely typed (data: {}) — actual Amadeus response structure is not fully documented in the OpenAPI spec
Citations
- —Endpoint price is $0.03 per request (specifically $0.0324 as shown in x-payment-info)https://stabletravel.dev/openapi.json
- —Payment settles via Tempo (chainId 4217) in pathUSD with no API keys requiredhttps://stabletravel.dev/openapi.json
- —Typical hotel booking workflow: list → search → offer → bookhttps://stabletravel.dev/docs
- —Required parameter is hotelId (Amadeus hotel ID)https://stabletravel.dev/openapi.json