Skip to content

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://developers.booking.com/_mock/connectivity/docs/openapispecs/rooms-api/rooms-api-specification-bulk/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)
Response
{
  "data": {
    "language_code": "EN_GB",
    "unit_types": [
      {
        "unit_type_id": 0,
        "unit_type_name": "string",
        "is_multi_room": true,
        "is_active": true,
        "valid_property_categories": [
          0
        ],
        "suggested_unit_names": [
          {
            "unit_name_id": 0,
            "unit_name": "string"
          }
        ]
      }
    ],
    "unit_names": [
      {
        "unit_name_id": 0,
        "unit_name": "string"
      }
    ],
    "bed_types": [
      {
        "bed_type_id": 0,
        "bed_type_name": "string",
        "bed_type_description": "string",
        "bed_type_description_imperial": "string",
        "is_active": true
      }
    ],
    "property_categories": [
      {
        "code": 0,
        "name": "string",
        "code_ota": 0,
        "code_booking_extended": 0
      }
    ],
    "unit_categories": [
      {
        "category_id": 0,
        "category_name": "string"
      }
    ]
  },
  "warnings": [
    {
      "message": "string",
      "code": 0,
      "details": {
        "fields": [
          "string"
        ]
      },
      "description": "string"
    }
  ],
  "errors": [
    {
      "message": "string",
      "code": 0,
      "details": {
        "fields": [
          "string"
        ]
      },
      "description": "string"
    }
  ],
  "meta": {
    "ruid": "string"
  }
}