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

Charges created, updated, or deleted successfully.

Bodyapplication/json

warningsArray of objects(ApiError)

errorsArray of objects(ApiError)

metaobject(ResponseMeta)

Response

{
  "warnings": [],
  "errors": [],
  "meta": {
    "ruid": "ed4af6d4-605c-433c-8971-b33a1f95aabb"
  }
}