Retrieve Property Settings Damage Programme

This endpoint allows partners to retrieve the terms and conditions of the Damage Payment Request Process (DPRP) associated with their property on the Booking.com platform.


Endpoint

POST

Header
Type
Required
Description

app-id

string

Yes

Your application ID. Required for authentication.

Authorization

string

Yes

Your API key for authorization.

Content-Type

string

Yes

Must be set to application/json.


Attributes

language_code string (Required)

Specify the language code in which you want the terms to be returned in.

Accepts the values listed under BCL.


Sample Request


Response

Sample Success Response

Success Response Body Elements

Status string

Indicates the overall status of the request. In this case, "Success" means the operation was completed successfully.

Message string

Provides a brief message about the outcome. Here, it states "Successfully fetch details," confirming that the requested information was retrieved.

data string

Contains detailed terms regarding the Damage Payment Request Process (DPRP) between the accommodation (the Partner) and Booking.com. This text outlines the responsibilities, conditions, and processes involved in handling damage fees incurred during a guest's stay.

Errors

Sample Error Response 1

Sample Error Response 2

Sample Error Response 3

Sample Error Response 4


Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.


Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.


Message string

A message providing more information about the error.

Last updated

Was this helpful?