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
Languages
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'

Responses

OK

Body*/*
dataobject(Charges)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)

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 POST \
  '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": {}
              }
            ]
          }
        ]
      }
    ]
  }'

Responses

OK

Body*/*
dataobject
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)

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