Last updated

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.

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:

✓ https://demandapi-sandbox.booking.com/3.1

When using the "Try out" console in this developer portal, select the sandbox environment before sending requests:

sandbox environment

Do not use production environment with test accommodation

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 IDNameLocationCancellation policiesPayment timingTesting scenario
10507360Demand API Sandbox Hotel OrionAmsterdam, The NetherlandsFree cancellation until; variable fees afterPay online now/later and pay at propertyMultiple 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.
12337Apartment in CefalúCefalú, ItalyFree / Non-refundablePay online now/laterMeal plan & cancellation testing, multiple extra charge types, and payment options (prepayment vs pay at property).
42709Test Otel IstanbulIstanbul, TurkeyNon-refundablePay online nowPricing 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.
3427703Ray's Lyon PropertyLyon, FranceFree cancellationPay online now/laterUseful for testing low-availability behaviour, mix of refundable and non-refundable policies, and multiple occupancy configurations.
4462291Demand API Test HotelLeiden, The NetherlandsFree cancellationPay online now/laterMulti-room bookings, with varying occupancies and cancellation options.
5476508"Home" ApartmentVincennes, Paris, FranceNon-refundablePay online nowMinimum stay restrictions and longer booking lead times.

Includes extra charges and multiple room options with varying maximum occupancies and free cancellation options.
2098153Panda HotelShanghai, ChinaFree cancellation until; variable fees afterPay online now/later and pay at propertyInternational 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: