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.

With Demand API sandbox, you can experiment with accommodation endpoints the search, availability, reservations and cancellations capabilities without worrying about making live production accommodation reservations.

It grants you access to a dedicated sandbox hotel designed exclusively for testing purposes.

Before you start using the Demand API sandbox make sure that you meet all the requirements needed to have access to our endpoints.

Sandbox hotel

The Sandbox hotel created for testing reservations, cancellations and fetching reservations is:

✓ Accommodation ID 10507360 - Demand API sandbox Hotel Orion.

This is a mock hotel created exclusively for testing purposes.

Use it in your requests to play around with the endpoints.

Sandbox environment

All sandbox requests should use the following base URL to interact with the API during testing:

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

When using the "Try out" tool in this portal, make sure you select the sandbox environment before sending your requests:

sandbox environment

  • Get familiar with the most common flow, following the steps described in the getting started guide but using the Sandbox hotel.
Attention

The Demand API sandbox is for testing and discovery purposes only; do not use it in production environments.

Authentication

  • There are no sandbox specific API Keys.

  • Use your generated API Key and Affiliate id for both production and sandbox environments.

It is imperative to adhere to all necessary security measures to safeguard your API Keys and data, and not exposing them during testing.

Refer to the Authentication guide for more details on security measures.

Limitations

The Demand API sandbox is subject to following limits:

Limitations
In the requests
  • Sandbox API requests are capped at 50 requests per minute to avoid overwhelming the system and to simulate real-world constraints.

In reservations and payments

  • Reservations are limited to the sandbox hotel: Demand API Sandbox Hotel Orion (id - 10507360)

  • To test reservations and payments in the sandbox environment, you need a real credit card with enough funds.

    • Reservations then are automatically cancelled every Monday.
    • Refund is initiated for any amount paid every Monday to. It won't result in any actual charges beyond the refund process.

Check the Payment quick guide for further details on testing payments.

Summary

Use the Demand API sandbox to safely test API calls, manage reservations and cancellations, and explore the system without affecting live data.

Remember to use your sandbox-specific hotel ID and follow best practices for authentication and rate limits.

What's next

Read the following guidelines to get familiar with Demand API and particularly to the accommodation endpoints and how to use them:

Previous page
Next page