docs / car-rental

Car Rental

Compare rental cars, prices and availability worldwide.

base /car-rental/v12 endpoints

post/car-rental/v1/cars/search2 credits

aggregated rental-car offers for a location + dates → offers[]{vehicle(name/category/ACRISS/transmission/seats/bags/fuel), price{amount,currency}, supplier(name/rating/pickup_address/coords), pickup.type, mileage, fuel_policy, free_cancellation, book_url} + facets. Location via `query` OR explicit place_id/city_id/country_id. One-way via drop_query. Dates pickup_date/dropoff_date (YYYY-MM-DD).

Parameter		Allowed / range	Description
query	optional	—	Pickup location to resolve (city / airport name). Provide this OR an explicit place_id + city_id + country_id.
place_id	optional	—	Explicit DiscoverCars place id (from cars/autocomplete). Use together with city_id + country_id to skip resolution.
city_id	optional	—	Explicit DiscoverCars city id (pairs with place_id + country_id).
country_id	optional	—	Explicit DiscoverCars country id (pairs with place_id + city_id).
pickup_date	optional	—	Pickup date (YYYY-MM-DD). Defaults to ~30 days out if omitted.
dropoff_date	optional	—	Drop-off date (YYYY-MM-DD). Defaults to ~30 days out if omitted.
pickup_time = 10:00	optional	—	Pickup time of day (HH:MM, 24h). Default 10:00.
dropoff_time = 10:00	optional	—	Drop-off time of day (HH:MM, 24h). Default 10:00.
currency = EUR	optional	—	ISO-4217 currency for prices (e.g. EUR, USD, GBP). Default EUR.
residence_country = US	optional	—	Driver's country of residence (ISO-2, e.g. US, GB) — affects pricing/availability. Default US.
driver_age = 35	optional	18–99	Driver age (affects young/senior-driver fees). Default 35.
drop_query	optional	—	Different drop-off location (city/airport name) for a one-way rental. Omit for same-location return.
drop_place_id	optional	—	Explicit drop-off place id (one-way; pairs with drop_city_id).
drop_city_id	optional	—	Explicit drop-off city id (one-way).
drop_country_id	optional	—	Explicit drop-off country id (one-way).
max_offers	optional	1–	Cap the number of offers returned. Omit for all.
include_facets = true	optional	—	Include aggregation facets (supplier/category/price buckets) in the response. Default true.
prefer_airport = true	optional	—	When resolving `query`, prefer the airport location over downtown. Default true.

Try in playground →

post/car-rental/v1/cars/autocomplete1 credit

resolve a location string (`query`) → place/city/country IDs (for cars/search)

Parameter		Allowed / range	Description
query	required	—	Location string to resolve into place/city/country IDs.

Try in playground →

Example request · cars/search

curl -X POST https://api.reefapi.com/car-rental/v1/cars/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Madrid Airport","currency":"EUR","pickup_date":"2026-07-28","dropoff_date":"2026-07-31","max_offers":40}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}