Charges API (1.0)

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

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

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.

Variables

Most of the endpoints (especially POST/PUT/DELETE) require you to add a path or query parameter before sending the request. The Open API specification marks these parameters with placeholder tags. For example, {{property_id}}. You can use the Environments tab to manage the values for these placeholders as variables.

Path parameters

  • Required: Must be provided to make the request
  • Type validation: Ensures correct data types (integer, string, etc.)
  • Example: propertyId in /charges-api/properties/{propertyId}/charges

Query parameters

  • Optional: Usually have default values
  • Example: language_code with en-us as the default value