latestOpenAPI 3.1.02026-08-10390815.4 KB

e5f3dccae7ca

Cars

Search car rentals

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

post/cars/search

Headers

X-Affiliate-Idinteger required

Include here your Affiliate identifier number

Request body

currencystring 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 <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.

maximum_resultsinteger

The maximum number of results to return per page.

languagestring

Effects on the selected language of the target website after redirection by provided url.

pagestring

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

Example request

{
  "booker": {
    "country": "nl"
  },
  "currency": "EUR",
  "language": "en-us",
  "route": {
    "dropoff": {
      "datetime": "2025-11-10T11:05:00",
      "location": {
        "airport": "AMS"
      }
    },
    "pickup": {
      "datetime": "2025-11-05T11:05:00",
      "location": {
        "airport": "AMS"
      }
    }
  }
}

Response

Successful response.

request_idstring

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

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.

Example response

{
  "data": [
    {
      "price": {
        "currency": "EUR"
      },
      "route": {
        "dropoff": {
          "depot": 5944
        },
        "pickup": {
          "depot": 5944
        }
      }
    }
  ]
}