Implementing the Value Adds Catalog API
Retrieve value adds and their details using the Value adds catalog API.
Retrieving value adds
GET https://supply-xml.booking.com/valueadds/properties/catalog
The GET /valueadds/properties/catalog request retrieves a list of value adds and their details.
Response body example
Click to view the full list of Booking.com supported value adds and their details.
List of supported value adds is mostly static
The following response lists all the Booking.com supported value adds and their details. Updates to this list are quite infrequent but they sometimes do happen. Use the endpoint response to get up-to-date information and pick up any newly introduced value adds at Booking.com.
[ { "id": 1001, "category": "Transportation", "type": "Parking", "name": "Self: 1 car Per room - per stay", "attributes": [] }, { "id": 1002, "category": "Transportation", "type": "Parking", "name": "Valet: 1 car Per room - per stay", "attributes": [] }, { "id": 6001, "category": "Transportation", "type": "Airport transfer", "name": "Roundtrip", "attributes": [] }, { "id": 6002, "category": "Transportation", "type": "Airport transfer", "name": "One way", "attributes": [] }, { "id": 2001, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Daily Credit Per adult - No Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2002, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Daily Credit Per adult - Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2003, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Daily Credit Per room - No Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2004, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Daily Credit Per room - Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2009, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Services Discount", "attributes": [ { "name": "Percentage", "dataType": "double", "description": "Percentage discount applied. Must be greater than 0 and less than or equal to 100.", "required": true } ] }, { "id": 2013, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Per stay credit - per adult", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2014, "category": "Food and Beverage (F&B)", "type": "Credit or discount", "name": "Per stay credit - per room", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 9001, "category": "Food and Beverage (F&B)", "type": "Bottle of wine", "name": "Bottle of wine", "attributes": [] }, { "id": 9002, "category": "Food and Beverage (F&B)", "type": "Bottle of champagne", "name": "Bottle of champagne", "attributes": [] }, { "id": 2005, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Daily Credit Per adult - No Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2006, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Daily Credit Per adult - Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2007, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Daily Credit Per room - No Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2008, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Daily Credit Per room - Daily Accrual", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2010, "category": "Property Services (PS)", "type": "Discount", "name": "Discount", "attributes": [ { "name": "Percentage", "dataType": "double", "description": "Percentage discount applied. Must be greater than 0 and less than or equal to 100.", "required": true } ] }, { "id": 2011, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Per stay credit - per adult", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 2012, "category": "Property Services (PS)", "type": "Credit or discount", "name": "Per stay credit - per room", "attributes": [ { "name": "CurrencyCode", "dataType": "string", "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.", "required": false }, { "name": "Amount", "dataType": "double", "description": "Specifies an estimated worth of the value add included in the rate.", "required": true } ] }, { "id": 5001, "category": "Internet Services (PS)", "type": "HighSpeed Internet", "name": "Per stay - per room", "attributes": [] }, { "id": 3001, "category": "Frontdesk services", "type": "Early Check-in", "name": "Early Check-in", "attributes": [ { "name": "Hour", "dataType": "int", "description": "Specifies the minimum hour of the day the check-in is allowed.", "required": true } ] }, { "id": 3002, "category": "Frontdesk services", "type": "Late Check-out", "name": "Late Check-out", "attributes": [ { "name": "Hour", "dataType": "int", "description": "Specifies the maximum hour of the day the check-out is allowed.", "required": true } ] }, { "id": 3003, "category": "Frontdesk services", "type": "Late Check-in", "name": "Late Check-in", "attributes": [ { "name": "Hour", "dataType": "int", "description": "Specifies the maximum hour of the day the check-in is allowed.", "required": true } ] }, { "id": 4001, "category": "Wellness", "type": "Spa", "name": "Unlimited access Per day - per adult", "attributes": [] }, { "id": 4002, "category": "Wellness", "type": "Spa", "name": "Hourly access Per day - per adult", "attributes": [ { "name": "Hour", "dataType": "int", "description": "Specifies the number of hours allowed at the spa per day, per adult.", "required": true } ] }, { "id": 4003, "category": "Wellness", "type": "Massage", "name": "N minutes Per stay - per adult", "attributes": [ { "name": "Minute", "dataType": "int", "description": "Specifies the duration of massage service in minutes included per stay, per adult.", "required": true } ] }, { "id": 7001, "category": "Activities", "type": "Safari game drive", "name": "Per day - per room", "attributes": [] }, { "id": 7002, "category": "Activities", "type": "Safari walk", "name": "Per day - per room", "attributes": [] }, { "id": 8001, "category": "Pets", "type": "Pets", "name": "Per day - per room", "attributes": [ { "name": "NumPets", "dataType": "int", "description": "Specifies the number of allowed pets. Minimum: 1 Maximum: 5", "required": true } ] } ]
Response body parameters
The following table describes the response elements:
| Element | Description | Type | Notes |
|---|---|---|---|
> id | Specifies the Booking.com ID for the value add. | integer | |
> category | Specifies the category that the value adds are grouped under. | string | For example, Wellness is a value adds category. |
> type | Specifies the sub-category of the value adds item. | string | For example, Spa is a type of Wellness category. Note that you cannot choose two different value adds within the same value adds type. For example, when adding a value adds service from the Parking value adds type, you can either add the Self Parking - 1 car Per room - per stay (ID 1001) or Valet Parking - 1 car Per room - per stay (ID 1002) service but not both. |
> name | Specifies the value adds name. | string | For example, Hourly access Per day - per adult is a value add. |
> attributes | Contains additional details for certain value adds. | object | Depending on the additional attribute, the data type, description and whether the attribute is required can change. For example, when selecting the Hourly access Per day - per adult value adds, you can specify the number of hours allowed. Note that the Amount attribute is used only for display purposes and to show the perceived worth of the specific value-added service or product. For more information, see the things to remember section. |
>> name | Specifies the name of the attribute. | array | For example, Hour is the name of the value adds attribute. |
> dataType | Specifies the data type of the additional detail. | integer or string | For example, an integer denoting the number of hours allowed in the spa per adult per day. |
> description | Specifies the description of the additional detail. | string | |
> required | Specifies whether the additional detail is required. | boolean | Possible values are: - true - false |