Search hotel availability
POST/hotels/v1/availability
Searches for hotel availability across multiple providers based on search criteria. Supports filtering by hotels, check-in/check-out dates, occupancies, and other criteria. The API aggregates responses from multiple providers specified in the connectionCodes array.
Results include available hotel options with pricing, room details, board types, and cancellation policies. The response can be used for subsequent prebooking and booking operations.
Streaming (opt-in): Send Accept: text/event-stream to receive results as Server-Sent Events (SSE).
Each event is either update (merged snapshot after a provider completes) or done (final snapshot).
Event data is JSON with searchId, connectionCode (update only), completed, total, timedOut, and snapshot (SearchResponse shape).
A comment line : ping is sent periodically as a keepalive.
Request
Responses
- 200
- 503
Unary JSON or SSE stream. Client and provider failures on this path are still HTTP 200
with errors[] (ERR_CODE_* / ERR_TYPE_*), not HTTP 400.
Search and SSE only. In-flight semaphore full. Body is
{ "error": "aggregator saturated", "code": "RESOURCE_EXHAUSTED" }, not Hotels errors[].
Quote, book, and cancel are not gated by this limit.