---
title: "Rental terms"
method: GET
path: "/rentalcars/terms"
tags: ["RentalCars"]
---

# Rental terms

`GET /rentalcars/terms`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/rentalcars/terms`
- Auth: API key in header `X-API-KEY`

Terms text of the cheapest offer that matches make_and_model. Makes two upstream calls: a market-free search, then the terms.

## Query parameters

- `pickup_location` string, required
- `dropoff_location` string, nullable
- `pickup_date` string, date, required
- `pickup_time` string
- `dropoff_date` string, date, required
- `dropoff_time` string
- `drivers_age` integer
- `cor` string
- `currency` string
- `car_category[]` string[]
- `supplier[]` string[]
- `transmission[]` string[]
- `mileage[]` string[]
- `depot_location_type[]` string[]
- `fuel_type[]` string[]
- `fuel_policy_type[]` string[]
- `seat_capacity[]` string[]
- `pay_when[]` string[]
- `free_cancellation` boolean
- `minimum_supplier_rating` integer
- `minimum_four_doors` boolean
- `has_deals` boolean
- `has_insurance_inclusive_pricing` boolean
- `price_min` number
- `price_max` number
- `sort` 'NATURAL' | 'PRICE' | 'RATING' | 'DISTANCE' | 'GENIUS'
- `sort_ascending` boolean
- `filter_criteria` string
- `page` integer
- `per_page` integer

## Response `200`

- string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `404`: No offer matches the vehicle_id or the supplier in this search and market. Not billed.
- `422`: A parameter is missing or invalid. No request is made upstream. Not billed. Rentalcars rejected the search values, for example a filter value that is not in available_filters. Not billed.
- `503`: 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.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)
