Rooms API (1.0)

Contains Rooms API specification

Languages
Servers
https://supply-xml.booking.com/

rooms-api

Create, update, retrieve and delete property units

Operations

meta

Retrieve units meta data and translations

Operations

Get meta data for units

Request

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
Query
language_codestring

Language code for localization. Defaults to EN_GB.

Enum"EN_GB""EN_US""DE""NL""FR""ES""ES_AR""ES_MX""CA""IT"
show_inactiveboolean

Show/hide inactive unit and bed types

Default true
curl -i -X GET \
  'https://supply-xml.booking.com/rooms-api/meta?language_code=EN_GB&show_inactive=true'

Responses

OK

Body*/*
dataobject(UnitMeta)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)