# Rooms API

Contains Rooms API specification

Version: 1.2

## Servers

Test using live endpoint
```
https://supply-xml.booking.com/
```

## Download OpenAPI description

[Rooms API](https://developers.booking.com/_bundle/connectivity/docs/openapispecs/rooms-api/rooms-api-specification.yaml)

## rooms-api

Create, update, retrieve and delete property units

### Get units

 - [GET /rooms-api/properties/{property-id}/units](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/rooms-api/getunits.md): Get all active units for a property

### Create unit

 - [POST /rooms-api/properties/{property-id}/units](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/rooms-api/createunit.md): Create new unit for a property

### Delete unit

 - [DELETE /rooms-api/properties/{property-id}/units/{unit-id}](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/rooms-api/deleteunit.md): Delete existing unit for a property

### Update unit

 - [PATCH /rooms-api/properties/{property-id}/units/{unit-id}](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/rooms-api/updateunit.md): Update existing unit for a property

### Get deleted units (read only)

 - [GET /rooms-api/properties/{property-id}/deleted-units](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/rooms-api/getdeletedunits.md): Get all deleted units for a property (read only)

## meta

Retrieve units meta data and translations

### Get meta data for units

 - [GET /rooms-api/meta](https://developers.booking.com/connectivity/docs/openapispecs/rooms-api/rooms-api-specification/meta/getroommeta.md): Retrieve meta data required for unit creation and update for any supported language_code
    
    Retrieve the list of all unit type IDs allowed for creation/update. For each $.unit_types[*] record you will find:
        
        unit_type_id: the unit type ID you must provide with each create and update request
        unit_type_name: string representation of unit type ID (translatable)
        is_multi_room: attribute that defines what type of room types you can use add in your unit
        is_active: attribute that defines if a unit type is available for creation/update, inactive room types are available for read only
        valid_property_categories: list of property categories that allow creation of this unit type
        suggested_unit_names: list of unit names that we recommend to use in combination with this unit type
        
    Retrieve the list of all room name IDs allowed during unit creation/update. For each $.unit_names[*] record you will find:
        
        unit_name_id: the unit name ID you must provide with each create request
        unit_name: string representation of unit name ID (translatable)
        
    Retrieve the list of all bed type IDs allowed during unit creation/update. For each $.bed_types[*] record you will find:
        
        bed_type_id: the bed type ID you must provide when configuring rooms
        bed_type_name: string representation of bed type (translatable)
        bed_type_description: description of bed type size using metric units (translatable)
        bed_type_description_imperial: description of bed type size using imperial units (translatable)
        is_active: attribute that defines if a bed type is available for creation/update, inactive bed types are available for read only
        
    Retrieve the list of all property categories for which you can create a unit. For each property type you will find its name and category ID, as well as an OTA or a Booking.com extended code