Room type and rate plan management API

Value Adds Catalog API (1.0.0)

This API provides a list of value adds available for properties. The response can be in JSON or XML format depending on the Accept header. The value adds include dynamic attributes such as currency, amount, and more.

Download OpenAPI description

valueadds-api-specification.json

valueadds-api-specification.yaml

Overview

Servers

Test static response

https://developers.booking.com/_mock/connectivity/docs/openapispecs/valueadds-api/valueadds-api-specification/

Test using live endpoint

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

Value Adds

Retrieve catalog of value adds available for properties with dynamic attributes

Operations

Retrieve catalog of value adds for properties

Request

This endpoint returns a list of value adds, including dynamic attributes, in either JSON or XML format. The response format is determined by the Accept header.

Headers

Acceptstring

Specifies the response format. If omitted, JSON is returned by default.

Enum"application/json""application/xml"

curl -i -X GET \
  https://developers.booking.com/_mock/connectivity/docs/openapispecs/valueadds-api/valueadds-api-specification/valueadds/properties/catalog \
  -H 'Accept: application/json'

Responses

Successful response with a list of value adds.

Body

Array [

idinteger

Unique identifier for the value add.

Example: 2001

categorystring

Category of the value add (e.g., Food and Beverage, Spa).

Example: "Food and Beverage (F&B)"

typestring

Type of value add, such as Credit or Discount.

Example: "Credit or discount"

namestring

Name of the value add.

Example: "Daily Credit Per adult - No Daily Accrual"

attributesArray of objects(Attribute)

List of dynamic attributes for the value add.

]

Response

[
  {
    "id": 2001,
    "category": "Food and Beverage (F&B)",
    "type": "Credit or discount",
    "name": "Daily Credit Per adult - No Daily Accrual",
    "attributes": [ … ]
  }
]

About Try it

Learn how to effectively use the Try it feature in the Value Adds Catalog API documentation.

Use the Try it feature to send test request examples to the API endpoints directly from the developer portal and depending on the selected environment either see static, pre-built responses or dynamic responses from a test property.