# Historical Reservations API

Retrieve a property's historical reservation details for use in a revenue management system. Select room reservations by check-in date and optionally by status. Responses include stay dates, available occupancy, and guest and property price perspectives. Access requires a connection authorised to read the property's reservation history.

Version: 1.0.0
License: Copyright Booking.com. All rights reserved.

## Servers

Intended production API gateway; confirm availability and access before use
```
https://supply-xml.booking.com
```

## Security

### BearerAuth

[object Object]

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Historical Reservations API](https://developers.booking.com/_bundle/connectivity/docs/openapispecs/historical-reservations-api/historical-reservations-api-specification.yaml)

## Historical reservations

 - [GET /revenue-management-api/properties/{property_id}/historical-reservations](https://developers.booking.com/connectivity/docs/openapispecs/historical-reservations-api/historical-reservations-api-specification/historical-reservations/gethistoricalreservations.md): Retrieve eligible room reservations whose check-in dates fall within the inclusive requested range, grouped by property reservation. Both check_in_start and check_in_end are required in YYYY-MM-DD for
## About Try it

 - [Environment](https://developers.booking.com/connectivity/docs/openapispecs/historical-reservations-api/historical-reservations-api-specification/about-try-it/environment.md): ## Environment - **Mock (schema only)** returns schema-driven mock responses or predefined examples. Use it to inspect the response format; it does not verify live authentication, property access, or
 - [Request](https://developers.booking.com/connectivity/docs/openapispecs/historical-reservations-api/historical-reservations-api-specification/about-try-it/request.md): ## Request 1. Open **Try it** for the GET operation and select the environment. 2. For a live request, configure `Authorization: Bearer {access_token}`. Send `Accept: application/json` and `Accept-Ver
 - [Response](https://developers.booking.com/connectivity/docs/openapispecs/historical-reservations-api/historical-reservations-api-specification/about-try-it/response.md): ## Response Inspect the HTTP status and JSON response. A successful `200` response contains `data.property_id` and `data.property_reservations`. An empty reservation array is valid. Mock responses do
