GETTING STARTED
/
Sandbox
Last updated

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.

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
Important

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:

sandbox environment

Do not use production environment with test accommodation

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 IDNameLocationCancellation policiesTesting scenario
10507360Demand 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.
    • Verify cancellation schedules, price calculation, and booking logic for different room/meal configurations.
12337Apartment in Cefalú.Cefalú, Italy.Free cancellation / Non-refundable
  • Meal plan & cancellation testing, multiple extra charge types, and payment options (prepayment vs pay at property).
42709Test Otel Istanbul.Istanbul, Turkey.Non-refundable.
  • 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.
3427703Ray's Lyon Property.Lyon, France.Free cancellation.
  • Useful for testing low-availability behaviour, mix of refundable and non-refundable policies, and multiple occupancy configurations.
4462291Demand 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.
    • Includes extra charges and multiple room options with varying maximum occupancies and free cancellation options.
2098153Panda HotelShanghai, China.Free cancellation until; variable fees after.
  • International bookings, 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:

Previous page
Next page