Charges API (1.0)

Create and update charges that apply at the property and room level, and setup up different configurations for different dates.

Download OpenAPI description

charges-api-specification.json

charges-api-specification.yaml

Overview

URL https://connect.booking.com

Connectivity Team connectivity@booking.com

Servers

Test static response

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

Test using live endpoint

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

Charges endpoint

Lists the details of the Charges endpoints to set and retrieve taxes and fees at the property and room level.

Operations

Charges meta endpoint

Lists the details of the Charges meta endpoint to retrieve a full list of charge types supported by the Charges API.

Operations

Retrieve Charges meta information

Request

Retrieve a full list of charge types supported by the Charges API. The API returns:

Charge type names translated in the specified language
Their corresponding OTA codes
The charge category each type belongs to

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"

curl -i -X GET \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-api/meta?language_code=EN_GB'

Responses

Bodyapplication/json

dataArray of objects(ChargeTypeMetaEntry)

warningsArray of objects(ApiError)

errorsArray of objects(ApiError)

metaobject(ResponseMeta)

Response

application/json

{
  "data": [
    { … }
  ],
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}

About Try it

Learn how to effectively use the Try it feature in the Charges 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.