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

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

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

Get property and room charges

Request

Retrieve the current charges for a property in format consistent with the creation/update payload.

Path

propertyIdinteger(int32)required

curl -i -X GET \
  'https://supply-xml.booking.com/charges-api/properties/{propertyId}/charges'

Experience it firsthand in the API Explorer!

Responses

Body*/*

dataobject(Charges)

warningsArray of objects(ApiError)

errorsArray of objects(ApiError)

metaobject(ResponseMeta)

Was this page helpful?

Create, update, and delete property and room charges

Request

Add or update taxes and fees at the property or room-level.

Path

propertyIdinteger(int32)required

Bodyapplication/jsonrequired

property_chargesArray of objects(Charge)

Charges that apply across the property. Update requests must contain at least one charge between property and room arrays.

room_chargesArray of objects(RoomCharges)

Room specific charges. Will override the same charge specified at the property level. Update requests must contain at least one charge between property and room arrays.

curl -i -X PUT \
  'https://supply-xml.booking.com/charges-api/properties/{propertyId}/charges' \
  -H 'Content-Type: application/json' \
  -d '{
    "property_charges": [
      {
        "charge_key": {
          "type": "SERVICECHARGE_ASIA",
          "guest_origin": "ANY",
          "travel_purpose": "ANY"
        },
        "charge_periods": [
          {
            "applicable": {
              "from": "string",
              "to": "string"
            },
            "configuration": {
              "amount": {
                "value": 0,
                "base": [
                  null
                ],
                "mode": "PER_NIGHT"
              },
              "excluded": true
            }
          }
        ]
      }
    ],
    "room_charges": [
      {
        "room_id": 4294967295,
        "charges": [
          {
            "charge_key": {
              "type": "SERVICECHARGE_ASIA",
              "guest_origin": "ANY",
              "travel_purpose": "ANY"
            },
            "charge_periods": [
              {
                "applicable": {},
                "configuration": {}
              }
            ]
          }
        ]
      }
    ]
  }'