Skip to content

Car order terms & conditions

Request

Retrieve the full, structured terms and conditions for one or more car rental orders.

The response contains hierarchical legal content organised into chapters containing nested sections, clauses, sub-clauses, and clause options.

Use cases: -Displaying full rental contract details to travellers. -Providing terms and conditions on order detail pages. -Recreating the booking voucher terms section. -Supporting legal and compliance requirements.

Notes: -Include at least one order ID. Invalid IDs will return null. -Language defaults to English if not specified or unsupported. Language uses an ISO 639-1 language code (for example en-gb). -You can optionally filter the response to return only voucher-required terms.

Security
BearerAuth
Headers
X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired
bookerobjectrequired

Information about the booker

languagestring(languageId)^[a-z]{2}(-[a-z]{2})?$

Optional. An ISO 639-1 language code (e.g. 'en-gb', 'es') indicating the preferred language for the terms and conditions.

Example:"en-us"
ordersArray of strings, non-emptyrequired

An array of car rental order IDs for which to retrieve terms and conditions. Must include at least one valid ID.

Example:
[ "765255700" ]
filtersobject

Optional filters that control which terms and conditions are returned.

import requests

url = "https://demandapi.booking.com/3.2/orders/details/cars/terms-and-conditions"

payload = {
  "booker": {
    "country": "gb"
  },
  "language": "en-gb",
  "orders": [
    "765255700",
    "invalid_order"
  ],
  "filters": {
    "voucher": True
  }
}

headers = {
  "Content-Type": "application/json",
  "X-Affiliate-Id": "0",
  "Authorization": "Bearer <YOUR_string_HERE>"
}

response = requests.post(url, json=payload, headers=headers)

data = response.json()
print(data)

Responses

Successful response containing terms and conditions for requested orders. Invalid IDs return null.

Bodyapplication/json
request_idstring(requestId)

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobject(Order terms map)

Map of order IDs to their terms and conditions. Invalid or missing orders return null.

Response
{ "request_id": "123456789", "data": { "765255700": {}, "invalid_order": {} } }