Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Rooms API (1.0)

Contains Rooms API description

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

meta

Retrieve listings meta data and translations

Operations

Get meta data for listings

Request

Retrieve meta data required for listing creation and update for any supported language_code

  • Retrieve the list of all listing type IDs allowed for creation/update. For each $.listing_types[*] record you will find:
    • listing_type_id: the listing type ID you must provide with each create and update request
    • listing_type_name: string representation of listing type ID (translatable)
    • is_multi_room: attribute that defines what type of room types you can use add in your listing
    • is_active: attribute that defines if a listing 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 listing type
    • suggested_listing_names: list of listing names that we recommend to use in combination with this listing type
  • Retrieve the list of all room name IDs allowed during listing creation/update. For each $.listing_names[*] record you will find:
    • listing_name_id: the listing name ID you must provide with each create request
    • listing_name: string representation of listing name ID (translatable)
  • Retrieve the list of all bed type IDs allowed during listing 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 listing. 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

Enum"EN_GB""EN_US""DE""NL""FR""ES""ES_AR""ES_MX""CA""IT"
curl -i -X GET \
  'https://supply-xml.booking.com/rooms-api/meta?language_code=EN_GB'
Experience it firsthand in the API Explorer!

Responses

OK

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

rooms-api

Create, update, retrieve and delete property listings

Operations