Skip to content

Sandbox Test Scenarios

Rates in the sandbox (development environment, https://hotels.sandbox.bookitapi.com) are test rates. Prices, availability and cancellation terms are not the properties' real rates and do not match production.

A fixed set of properties reproduces specific quote and booking outcomes, so you can check how your integration handles them before going live. Search for one of the properties below, quote any of its packages and book it. The outcome is the same for every package of the property.

Every other property quotes with no changes and books successfully.

Scenarios at a glance

Scenario Search Quote Book
Price change Returns packages 200 OK, higher totalPrice, changes contains PriceChanged Succeeds
Refundability change Returns packages 200 OK, opposite isRefundable, changes contains CancellationPolicyChanged Succeeds
Refundability date change Returns packages 200 OK, refundability date one day earlier, changes contains CancellationPolicyChanged Succeeds
Sold out Returns packages 404 Not Found, ROOM_SOLD_OUT —
Booking failure Returns packages 200 OK, no changes 409 Conflict, BOOKING_FAILED
Any other property Returns packages 200 OK, no changes Succeeds

Price change

The quote returns a higher room.package.totalPrice than search, and room.package.changes contains PriceChanged. The booking succeeds at the quoted price.

Property ID Name City Country
R:101996671 Essential by Dorint Interlaken Interlaken CH
R:4623245 The Cosmopolitan Of Las Vegas Las Vegas US
R:3388994 Park Plaza London Westminster Bridge London GB

Refundability change

The quote returns the opposite refundability from search: a refundable package quotes as non-refundable, and a non-refundable package quotes as refundable. room.package.changes contains CancellationPolicyChanged. The booking succeeds with the quoted cancellation terms.

Property ID Name City Country
R:216994 The Tower Hotel, by Thistle London GB
R:950543 Martinique New York on Broadway, Curio Collection by Hilton New York US
R:228706 Keio Plaza Hotel Tokyo Tokyo JP

Refundability date change

For a refundable package, the quote returns a refundability date one day earlier than search (cancellationPolicy.fullRefundability.to, and every fees[].since when the cancellation fee schedule is returned). room.package.changes contains CancellationPolicyChanged. Non-refundable packages quote with no changes. The booking succeeds with the quoted cancellation terms.

Property ID Name City Country
R:700820 London Marriott Hotel Grosvenor Square London GB
R:43769 Amsterdam Marriott Hotel Amsterdam NL
R:222075 Westgate New York Grand Central New York US

Sold out

Search returns packages for the property, but the quote fails with 404 Not Found and the error ROOM_SOLD_OUT because the room is no longer available. No packageBookingId is returned, so the package cannot be booked. Search keeps returning these packages, and every quote fails the same way.

Property ID Name City Country
R:7268270 Le Meridien New York, Central Park by Marriott New York US
R:221135 Pan Pacific Singapore Singapore SG
R:93432985 1 Hotel Mayfair London GB

Booking failure

Search and quote succeed and the quote reports no changes. The booking fails with 409 Conflict and the error BOOKING_FAILED, and no reservation is created. The packageBookingId cannot be used again; another attempt starts from a new quote.

Property ID Name City Country
R:1207722 L’Hôtel du Collectionneur Paris Paris FR
R:18085376 Hyatt Regency Amsterdam Amsterdam NL
R:66164978 CIVILIAN Hotel New York US