Cars rental endpoints examples
Find here some examples of Cars endpoints requests and responses, together with recommendations for your integration
With Cars API endpoints you can retrieve information about cars, suppliers, depots and even get the score breakdown assigned to a depot based on customer ratings.
Find in this section some examples, tips and best practices when using Cars API endpoints.
Static data cache
All the cars rental endpoints (apart from the /cars/search endpoint) return static data that may change infrequently, if at all - such as supplier names, depot address, or depot scores.
For those cases, we strongly recommend caching all endpoints and refreshing the cache on a daily basis, as using a local cache of static data reduces endpoint traffic and improves response times.
Do not cache the /cars/search endpoint, as this returns prices and/or availability data for vehicles, which can change frequently. If you cache this endpoint, it may cause a request to fail because the data is stale and invalid.
| Endpoint | Retrieves | Tips |
|---|---|---|
| /cars/details | All the relevant information about vehicles. | You can query the last modified date to update your cache of car details. |
| /cars/suppliers | Car rental suppliers and their logos. | It accepts a specific ID. If no ID is provided, it returns all suppliers. |
| /cars/depots | All available car rental depots. | The returned ID will not change unless a depot changes location. |
| /cars/depot/reviews/scores | The score breakdowns for specified depots. | These scores are based on customer ratings and displaying them might boost booking decision-making. |
/cars/details
→ Call the /cars/details endpoint to get relevant information about individual vehicles.
On your request, you can use the maxim_results parameter to reduce/increase the number of results.
Example:
{ "last_modified": "2023-11-01T11:05:00+00:00", "maximum_results": 100 }
Query the last modified date to update your cache of car details.
/cars/suppliers
→ Call the /cars/suppliers endpoint to retrieve a list of car rental suppliers and their logos.
If you want to get details about a specific supplier:
- Go to the cars/search response.
- Copy the returned supplier’s unique identifier (id).
- Use it in your /cars/supplier request.
- The returned response provides the details about the selected supplier, including the logo.
Example:
{ "suppliers": [ 62 ] }
To see the full list of available suppliers, do not specify any id.
Different supplier ids
As many of the car rental suppliers operate in multiple countries, you might receive different IDs for the same name.
Budget in country A has supplier id=2218, while Budget in country B has supplier id=62
{ "id": 2218, "name": "Budget", "logo": "https://cdn.rcstatic.com/sp/images/suppliers/2218.png" }, { "id": 62, "name": "Budget", "logo": "https://cdn.rcstatic.com/sp/images/suppliers/62.png" },
supplier idprovided in your cars/search response for the selected route/ country.
/cars/depots
→ Call the /cars/depots endpoint to see all available car rental depots.
On your request, you can use the maxim_results parameter to reduce/increase the number of results.
- Specify the ISO language code (in lowercase), that identifies the language you want to use in instructions provided in the response.
If you don’t specify any language code, en-gb is used by default.
Example:
{ "last_modified": "2023-11-01T11:05:00+00:00", "maximum_results": 100, "languages": [ "en-gb", "nl" ] }
/cars/depot/reviews/scores
Optionally you can retrieve the score breakdowns for specified depots together with the overall score.
These scores are based on customer ratings and showing them on the search results help travellers to make a more informed decision about the supplier and location they select.
→ Call the /cars/depot/reviews/scoresendpoint
On your request, you can use the maxim_results parameter to reduce/increase the number of results.
{ "maximum_results": 10 }