Skip to content
Charges API
/
/
Getting help

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

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.

Common issues

401 Unauthorized

  • Check authentication credentials
  • Verify API key is valid and not expired
  • Ensure credentials match the selected environment

400 Bad Request

  • Validate request payload against schema
  • Check required fields are provided
  • Verify data types match specification

404 Not Found

  • Confirm the resource ID exists
  • Check the endpoint URL is correct
  • Verify you have access to the resource

Getting help

If you encounter issues:

  1. Check the response error message for details
  2. Verify your request matches the API specification
  3. Contact the Connectivity Team for support

This documentation applies to all endpoints in the Charges API. The Try it feature provides a consistent testing experience across all operations.