Skip to content
API REFERENCES/
/Car rentals

Car rentals

This collection includes endpoints related to car rental services within the connected trip experience.
Use these endpoints to:
- Search and retrieve car details.
- Retrieve car specifications, depot locations, and supplier information.

Operations

Search car rentals

Request

Use this endpoint to retrieve the available car rentals matching the search criteria.

Security
BearerAuth
Headers
X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired
bookerobject(schemas-booker)required

Defines the booker context.

currencystring or null(currencyId)^[A-Z]{3}$required

A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

Example:"EUR"
driverobject(driver)required

Defines the driver context.

filtersobject(schemas-filters)

Defines the filtering criteria for refining the request results. It allows you to specify various parameters to narrow down the available car rental options based on specific attributes.

maximum_resultsinteger, multiple of 10, [ 10 .. 500 ](maximumResultsCarsSearch)

The maximum number of results to return for car searches.

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

Optional. Controls the language of the Booking.com web and app URLs returned in the response. If not specified, English (en-gb) is used.

Default:"en-gb"
Example:"en-us"
pagestring(page)

Pagination token used to retrieve the next page of results. Obtained from next_page.

paymentobject(paymentInput)

Payment-related input filters that allow you to narrow down car search results based on the payment timing options.

routeobject(routeInput)required

Defines the route context.

sortobject(sort)

Defines how the search results are sorted. If omitted, results are sorted by the recommended option.

curl -i -X POST \
  https://demandapi.booking.com/3.2/cars/search \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "booker": {
      "country": "nl"
    },
    "currency": "EUR",
    "driver": {
      "age": 36
    },
    "filters": {
      "transmission_type": "automatic",
      "mileage_type": "limited",
      "depot_location_type": "in_terminal",
      "fuel_types": [
        "hybrid",
        "petrol_or_diesel"
      ],
      "price": {
        "minimum": 125.2,
        "maximum": 300
      },
      "rating": {
        "minimum_review_score": 8
      }
    },
    "route": {
      "pickup": {
        "datetime": "2026-11-05T11:05:00",
        "location": {
          "airport": "AMS"
        }
      },
      "dropoff": {
        "datetime": "2026-11-10T11:05:00",
        "location": {
          "airport": "AMS"
        }
      }
    }
  }'

Responses

Successful response.

Bodyapplication/json
request_idstring(requestId)required

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

dataArray of objects(schemas-product)required
metadataobject(MetadataOutput)

Metadata about the request.

search_tokenstring

Encoded string that must be passed in subsequent requests to identify the context of the car search. Note: It is specific to Car rentals and differs from other tokens used in booking flows.

Response
{
  "request_id": "01h00fr9y7qkbxtc6kyv97j49z",
  "data": [
    { … }
  ],
  "metadata": {
    "next_page": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7Im1heGltdW1fcmVzdWx0cyI6MTAsIm9mZnNldCI6MTB9LCJhdWQiOiJDQVJTX1NVUFBMSUVSUyIsImV4cCI6MTY4MzY0NzMwNX0.y7NmH48mm7lImd2WxsHdotj6n-dVQAzJCGCnIJCKy3A",
    "total_results": 122
  },
  "search_token": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789"
}