# Demand API sandbox

**The Demand API Sandbox allows you to safely experiment with accommodation and attractions API collections, so you can validate search and availability, and bookings, modifications and cancellations for accommodation orders without affecting live production data.**

## What is the Sandbox?

The Demand API Sandbox is a dedicated, non-production environment designed to validate your integrations using your regular credentials and sample properties or attractions without affecting real inventory. It mirrors the structure of the live production environment, allowing you to simulate:

* The end-to-end booking journey for [accommodations](/demand/docs/open-api/3.2/demand-api/accommodations)- Validate search, availability, reservations, modifications and cancellations for accommodation.
* The search and look flow for [attractions (in Beta)](/demand/docs/open-api/3.2-beta/demand-api/attractions).


Before using the sandbox environment and test inventory, ensure you meet all the [requirements](/demand/docs/getting-started/try-out-the-api#before-you-start---prerequisites) for accessing our endpoints.

## Authentication

All sandbox inventory (accommodations and attractions) use the **same authentication details as production**, and is designed to simulate different search, booking, payment, and cancellation behaviours.

* No sandbox-specific API keys are required.
* Use your standard [API Key token](/demand/docs/development-guide/authentication#generate-an-api-key) and [Affiliate id](/demand/docs/development-guide/authentication#affiliate-id-management) for your requests.


Always follow best practices to secure your API keys during testing.

See the [Authentication guide](/demand/docs/development-guide/authentication/) for more details.

## Sandbox environment

Use the following base URL for all sandbox requests:

div
strong
✓ https://demandapi-sandbox.booking.com/3.2
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 any request:

![sandbox environment](/assets/sandbox-environment.bb872227ba4e2b3ba114425efa30f1e15a36efcce241fb4ab11285cc14180e8b.33f15c9b.png)

Do not use production environment with test inventory
The sandbox is for testing and discovery purposes only. Using sandbox accommodation or attraction IDs in the production environment will return an error or empty results.

## Sandbox accommodations

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.

| Accommodation 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.
  * Verify cancellation schedules, price calculation, and booking logic for different room/meal configurations.

 |
| **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).
  * Prepayment required for all bookings, allowing testing of online payment flows and payment timing options.

 |
| **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.
  * 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. | * International bookings, multi-currency and pay at the property payment tests.

 |


## Sandbox attractions

Use the following test attraction IDs to experiment with the attractions endpoints. These are mock experiences designed to simulate different availability, pricing, and configuration scenarios.

**Recommended search parameters:**

* `sort: most-popular`
* `start_date: 2026-04-15`
* `end_date: 2026-04-30`


| Attraction ID | Name | Testing scenario |
|  --- | --- | --- |
| **PRGrwINoiRZl** | Reviews | Test review data retrieval and display logic. |
| **PRKKhInhUx5G** | The gallery | General attraction search with photos and display testing. |
| **PRLL7RsJ1haQ** | Availability - fluctuating prices, single offer | Validate dynamic pricing behaviour and single-offer availability flows. |
| **PRWWmXE65cUx** | Custom fields: transfer modes | Test handling of custom fields such as transport or transfer options. |
| **PRYLA1RKfQU5** | [Test] E2E integration test | End-to-end testing across search, availability, and booking flows. |


## Limitations

The sandbox environment has the following limitations:

* **Rate limiting** - Maximum 50 requests per minute ([details](/demand/docs/development-guide/rate-limiting#rate-limiting-in-sandbox)).
* **Reservations** - Only supported on sandbox inventory.
* **Payments** - A real credit card is required for testing accommodation booking flows including payments. Charges are temporary and automatically cancelled every Monday; refunds are processed automatically.


See [Payment quick guide](/demand/docs/payments/how-to#testing) for testing payments instructions.

## What's next

Read the following guides to get familiar with the Demand API and start integrating:

* [Try out guide](/demand/docs/getting-started/try-out-the-api/) for "Hello world" examples
* [Authentication guide](/demand/docs/development-guide/authentication)
* [Accommodation API Quick guide](/demand/docs/accommodations/accommodation-quick-guide)
* [Car rental API Quick guide](/demand/docs/cars/cars-quick-guide)