Demand API sandbox
The Demand API Sandbox allows you to safely experiment with accommodation search, availability, reservations, and cancellations without affecting live production data.
What is the Sandbox?
Sandbox is a test environment provided by Booking.com where you can make Demand API calls using your regular credentials and sample properties without affecting real accommodations, bookings, or financial transactions.
With the Demand API sandbox, you can use the accommodation endpoints to:
- Safely test API calls for search, availability, reservations, and cancellations.
- Explore different test accommodation scenarios without affecting live data.
Before using the sandbox environment and sandbox accommodation, ensure you meet all the requirements for accessing our endpoints.
Authentication
All sandbox properties use the same authentication details as production, and are designed to simulate different booking, payment, and cancellation behaviours.
No sandbox-specific API keys are required.
Use your standard API Key token and Affiliate id for your requests.
Always follow best practices to secure your API keys during testing.
See the Authentication guide for more details.
Sandbox environment
Use the following base URL for all sandbox requests:
The sandbox environment mirrors the behaviour of the corresponding API version. Make sure the version in the base URL matches the version you are integrating with.
When using the "Try out" console in this developer portal, select the sandbox environment before sending requests:
The sandbox is for testing and discovery purposes only. Using sandbox property IDs in the production environment will return an error.
Sandbox properties
Use the following test accommodation IDs in your requests to experiment with the endpoints. Each property is a mock hotel or apartment created exclusively for testing purposes.
| Sandbox ID | Name | Location | Cancellation policies | Testing scenario |
|---|---|---|---|---|
| 10507360 | ||||
| Demand API Sandbox Hotel Orion. | Amsterdam, The Netherlands. | Free cancellation until a deadline; variable fees after. | Multiple rate plans, meal options, per-person extra charges, and different prepayment requirements.
| |
| 12337 | Apartment in Cefalú. | Cefalú, Italy. | Free cancellation / Non-refundable | Meal plan & cancellation testing, multiple extra charge types, and payment options (prepayment vs pay at property). |
| 42709 | Test Otel Istanbul. | Istanbul, Turkey. | Non-refundable. | Pricing breakdowns with multiple tax types, different cancellation windows, and meal plan inclusion (breakfast vs no meals).
|
| 3427703 | Ray's Lyon Property. | Lyon, France. | Free cancellation. | Useful for testing low-availability behaviour, mix of refundable and non-refundable policies, and multiple occupancy configurations. |
| 4462291 | Demand API Test Hotel. | Leiden, The Netherlands. | Free cancellation. | Multi-room bookings, with varying occupancies and cancellation options. |
| 5476508 | "Home" Apartment. | Vincennes, France. | Non-refundable. | Minimum stay restrictions and longer booking lead times.
|
| 2098153 | Panda Hotel | Shanghai, China. | Free cancellation until; variable fees after. | International booking, multi-currency and pay at the property payment tests. |
Limitations
The sandbox environment has the following limitations:
- Rate limiting - Maximum 50 requests per minute (details).
- Reservations - Only supported on sandbox properties.
- Payments - A real credit card is required for testing. Charges are temporary and automatically cancelled every Monday; refunds are processed automatically.
See Payment quick guide for testing payments instructions.
What's next
Read the following guides to get familiar with the Demand API and start integrating:
- Try out guide for "Hello world" examples
- Authentication guide
- Accommodation API Quick guide
- Car rental API Quick guide