Demand API sandbox
The Demand API Sandbox allows you to safely experiment with accommodation search, reservations, and cancellations without affecting live production data.
What is 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 scenarios and 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:
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 production with sandbox IDs will return an error.
Sandbox accommodation
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 | Payment timing | Testing scenario |
---|---|---|---|---|---|
10507360 | Demand API Sandbox Hotel Orion | Amsterdam, The Netherlands | Free cancellation until; variable fees after | Pay online now/later and pay at property | Multiple rate plans, meal options, per-person extra charges, and different prepayment requirements. Verify cancellation schedules, price calculation, and booking logic for different room/meal configurations. |
12337 | Apartment in Cefalú | Cefalú, Italy | Free / Non-refundable | Pay online now/later | Meal plan & cancellation testing, multiple extra charge types, and payment options (prepayment vs pay at property). |
42709 | Test Otel Istanbul | Istanbul, Turkey | Non-refundable | Pay online now | Pricing breakdowns with multiple tax types, different cancellation windows, and meal plan inclusion (breakfast vs no meals). Prepayment required for all bookings, allowing testing of online payment flows and payment timing options. |
3427703 | Ray's Lyon Property | Lyon, France | Free cancellation | Pay online now/later | 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 | Pay online now/later | Multi-room bookings, with varying occupancies and cancellation options. |
5476508 | "Home" Apartment | Vincennes, Paris, France | Non-refundable | Pay online now | Minimum stay restrictions and longer booking lead times. Includes extra charges and multiple room options with varying maximum occupancies and free cancellation options. |
2098153 | Panda Hotel | Shanghai, China | Free cancellation until; variable fees after | Pay online now/later and pay at property | International bookings and multi-currency 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: Real credit card required. Temporary payments are auto-cancelled every Monday; refunds processed automatically.
See Payment quick guide for testing payments instructions.
What's next
Read the following guidelines to get familiar with Demand API and how to use the different API collections:
- Try out guide for "Hello world" examples.
- Authentication guide
- Accommodation API Quick guide
- Car rental API Quick guide