Charges API
/
Charges endpoint
/
Get property and room charges

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

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://developers.booking.com/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-api/properties/{propertyId}/charges'

Responses

OK

Bodyapplication/json
dataobject(Charges)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)
Response
application/json
{
  "data": {
    "property_charges": [ … ],
    "room_charges": [ … ]
  },
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}

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://developers.booking.com/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-api/properties/{propertyId}/charges' \
  -H 'Content-Type: application/json' \
  -d '{
    "property_charges": [
      {
        "charge_key": {
          "type": "CLEANINGFEE",
          "guest_origin": "ANY",
          "travel_purpose": "ANY"
        },
        "charge_periods": [
          {
            "applicable": {
              "from": "2025-11-30"
            },
            "configuration": {
              "amount": {
                "value": 20,
                "base": [],
                "mode": "PER_STAY"
              },
              "excluded": true
            }
          }
        ]
      }
    ],
    "room_charges": []
  }'

Responses

OK

Bodyapplication/json
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)
Response
application/json
{
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}

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

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.