Search car rentals

Request

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

Security

BearerAuth

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(schemas-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"
}