Skip to main content
Use this pageChatGPTClaudeCursor · OpenAPI · MCP

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 (this connection's options/errors delta, not a merged snapshot) or done (final merged snapshot as SearchResponse, including timed-out connections). Event data is JSON with searchId, connectionCode (update only), completed, total, timedOut, plus options/errors on update or snapshot on done. SSE JSON matches unary Connect JSON (enum names, unpopulated bools/zeros present, RFC 3339 timestamps). Pre-fan-out refusals (invalid/past stay dates, hotelCodeProvider) still answer application/json with errors[] even when Accept is text/event-stream. A comment line : ping is sent periodically as a keepalive.

Request​

Responses​

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. When Accept is text/event-stream, pre-fan-out refusals (stay dates, hotelCodeProvider) may still return application/json SearchResponse with errors[].