Get the rental terms text of an offer: key info such as the deposit and the chapters of the supplier policy. The endpoint has two modes. In direct mode you send search_key and vehicle_id from a search with cor=auto. This mode makes 1 upstream call. In lookup mode you send the search parameters and the supplier. The endpoint then runs a market-free search itself and finds the matching offer. This mode makes 2 upstream calls and takes longer. The supplier must exist in that market, else the endpoint returns 404 rentalcars_offer_not_found. The matched_offer object shows how the offer matched (match_level). Scrappa is not affiliated with Rentalcars.com. This is an unofficial API.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
10 optional filters available.
string
Optional
Direct mode. The search_key from a /search response with cor=auto.
example
string
Optional
Direct mode. The vehicle_id from the same /search response.
1234567890
string
Optional
Lookup mode. A 3-letter IATA code or "lat,lng".
BER
string
Optional
Lookup mode. Pickup date in Y-m-d format.
2026-12-01
string
Optional
Lookup mode. Dropoff date in Y-m-d format.
2026-12-04
integer
Optional
Lookup mode. Age of the driver, from 18 to 99. Default: 30.
10
string
Optional
Lookup mode. Supplier name. Example: Alamo.
Alamo
string
Optional
Lookup mode. Car make and model from a search response. It narrows the match.
example
string
Optional
Lookup mode. Car class code from a search response. It narrows the match.
example
string
Optional
Lookup mode. The pickup_depot_id of an offer. It narrows the match.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
terms
matched_offer
search_parameters
{
"meta": {
"attempts": 2,
"duration_ms": 5,
"endpoint_family": "terms"
},
"terms": {
"chapters": [
{
"title": "Included in the rental price",
"sections": [
{
"title": "Insurance, Covers and Waivers",
"clauses": [
{
"text": "Insurance information\n All rental cars must have Collision Damage Waiver (CDW) and Theft Protection (TP). Each policy will be either: included or\n purchasable from the rental company, or\n provided by another company (e.g. your credit card company).",
"title": "Insurance Information"
},
{
"text": "Covers the driver\u2019s liability for any injuries and property damage that are included in the policy. It does not cover injuries to the driver or damage to the rental car. This cover is only valid if you stick to the terms of the rental agreement.",
"title": "Third-Party Liability (TPL)"
},
{
"text": "If the car is stolen, or seriously damaged, or damaged in an incident involving someone else, please contact the rental company and the police immediately. If you can't provide the necessary documents from the police, you'll be liable for the full cost of replacing/repairing the car. \n\nIf the car gets slightly damaged, and no-one else is involved, please contact the rental company immediately.\nThe rental company is not liable for the loss of / theft of / damage to any belongings in the car, during or after the rental.\nDamage to the car will be charged for by the car hire company after it is dropped off - and will incur a Damage Administration fee on top of the amount deducted from the excess.\nNot included in the rental cover (CDW & TP)\n Loss of / theft of / damage to: keys, aerials, jack, safety triangles and vests, windscreen wipers, petrol cap, luggage covers, or any other fixed or mobile component of the car.",
"title": "Loss or Damage"
}
]
},
{
"title": "Roadside assistance",
"clauses": [
{
"text": "When you pick your car up, please make sure you find out where the paperwork is kept. In most cases, it\u2019ll be in the glove box or attached to the sun visor.",
"title": "Roadside assistance"
}
]
},
{
"title": "Mileage / Kilometres",
"clauses": [
{
"text": "Your rental includes unlimited free kilometres.\nChanging the length of your rental can affect how many kilometres you can drive for free. It can also affect how much you will pay for each additional kilometre.",
"title": null
}
]
}
]
},
{
"title": "Not included in the rental price",
"sections": [
{
"title": "Local Charges",
"clauses": [
{
"text": "This section shows charges that you\u2019ll pay at the counter because of (a) where you're picking your car up, (b) who's driving, and (c) where you go during your rental. It doesn\u2019t show other over-the-counter costs, such as charges for fuel, child seats or additional services.",
"title": null
},
{
"text": "You are responsible for any charges and fines, including tolls, congestion charges, speeding tickets and parking or traffic fines.",
"title": "Fines"
}
]
},
{
"title": "Mandatory Coverage",
"clauses": [
{
"text": "This rental doesn\u2019t include Collision Damage Waiver.\n \nUnless you have another policy that provides protection, you will be responsible for the full cost of repairing or replacing the car if it gets damaged.\nPlease bring a letter from your credit card company, confirming that you have the right cover for this rental. If you can't supply this proof, the counter staff will insist that you buy the cover at the counter.",
"title": null
},
{
"text": "This rental doesn\u2019t include Theft Protection.\n \nUnless you have another policy that provides protection, you will be responsible for the full cost of replacing or repairing the car if it is stolen, or damaged while someone is trying to steal it.\nPlease bring a letter from your credit card company, confirming that you have the right cover for this rental. If you can't supply this proof, the counter staff will insist that you buy the cover at the counter.",
"title": null
}
]
},
{
"title": "Additional drivers",
"clauses": [
{
"text": "The main driver (the person named on the booking) must be present when you pick the car up, and must be the one who pays anything charged at the counter. There may be a daily fee for additional drivers. The rental terms, including age-related restrictions and fees, apply to any additional drivers.\nThe cost to add an additional driver is \u20ac14.70 per day, \u20ac73.48 per week, up to a maximum of \u20ac293.93 per rental including tax.",
"title": "Additional drivers"
}
]
}
]
}
],
"key_info": {
"common": {
"supplier": "Alamo",
"driverAge": 30,
"rentalDuration": 3,
"debitCardsAllowed": true,
"countryOfResidence": "US",
"creditCardsAllowed": true,
"destinationCountry": "DE",
"insuranceAvailable": true
},
"deposit": {
"title": "Security deposit",
"content": [
"At pick-up, the main driver will leave a refundable security deposit of 700 EUR on their credit or debit card."
],
"warning": null,
"subtitle": {
"value": 700,
"symbol": "EUR"
},
"acceptedCards": [
{
"type": "Mastercard",
"title": "MasterCard"
},
{
"type": "Visa",
"title": "Visa"
}
],
"acceptedCardsTitle": "Accepted cards"
},
"mileage": {
"title": "Clause.mileage.title",
"content": "Your rental includes unlimited free kilometres.",
"subtitle": "Unlimited"
},
"crossBorder": {
"title": "searchResult.text.crossBorder",
"content": [
"Cross-border by request. Cars can be driven within Europe with the following exceptions: Albania, Armenia, Azerbaijan, Belarus, Bosnia, Bulgaria, Estonia, Georgia, Greece, Kazakhstan, Kosovo, Kyrgyzstan, Latvia, Lithuania, Macedonia, Moldova, Montenegro, Romania, Russia, Serbia, Tajikistan, Turkey, Turkmenistan, Ukraine, United Kingdom, and Uzbekistan. Should you bring the vehicle outside Germany, a cross-border fee of \u20ac41.65 per rental will apply. \n\nMercedes and BMW models\u2014convertibles, premium SUVs, trucks, and cargo vans\u2014can\u2019t be driven into Croatia, Czech Republic, Hungary, Italy, Poland, Slovakia, and Slovenia. Jeep Grand Cherokee can\u2019t be driven outside Germany",
"Customers must inform the car hire company of any cross-border travel as restrictions may apply in certain countries where the car cannot be taken."
]
},
"disclaimers": [
"Please see the Service Provider\u2019s full terms and conditions below, which include the full name and company registered address of your Service Provider, information on and fees of extra products and services purchasable at the counter or based on your use of the rental, such as driving cross border and, if any, pick-up and drop-off grace periods."
],
"driverAndLicence": {
"title": "tr.groupedSearchResults.driverRequirementsTitle",
"topText": "When you pick the car up, you'll need:",
"neededItems": [
"Passport or national ID card",
"Driving licence",
"Credit or debit card"
]
}
},
"pay_on_pickup": false,
"supplier_name": "Alamo"
},
"matched_offer": {
"price": 221.78,
"currency": "EUR",
"supplier": "Alamo",
"car_class": "XXMR",
"vehicle_id": "859050623",
"match_level": "exact",
"make_and_model": "Wild Card",
"pickup_depot_id": "4829006"
},
"search_parameters": {
"mode": "lookup",
"engine": "rentalcars_terms",
"market": "GB",
"currency": "EUR",
"supplier": "Alamo",
"drivers_age": 30,
"rental_days": 3,
"make_and_model": null,
"pickup_datetime": "2026-11-08T10:00:00",
"pickup_location": "BER",
"dropoff_datetime": "2026-11-11T10:00:00",
"dropoff_location": "BER",
"pickup_location_type": "IATA",
"dropoff_location_type": "IATA"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. No request is made upstream. Not billed.
{
"errors": {
"pickup_location": [
"A pick-up location is required: an airport IATA code or \"latitude,longitude\"."
]
},
"message": "A pick-up location is required: an airport IATA code or \"latitude,longitude\"."
}Request Rejected
Rentalcars rejected the search values, for example a filter value that is not in available_filters. Not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false,
"duration_ms": 900,
"endpoint_family": "terms"
},
"error": {
"code": "rentalcars_request_rejected",
"message": "Rentalcars rejected the request. Check the parameters."
}
}Offer Not Found
No offer matches the vehicle_id or the supplier in this search and market. Not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false,
"duration_ms": 900,
"endpoint_family": "terms"
},
"error": {
"code": "rentalcars_offer_not_found",
"message": "No matching offer was found."
}
}Rentalcars Temporarily Unavailable
Rentalcars did not answer in time. Retry after a short pause. Other 503 codes start with rentalcars_ too, for example rentalcars_invalid_response. Not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": true,
"duration_ms": 900,
"endpoint_family": "terms"
},
"error": {
"code": "rentalcars_upstream_unavailable",
"message": "Rentalcars is temporarily unavailable. Please retry."
}
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.