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	Required
query	optional
place_id	optional
city_id	optional
country_id	optional
pickup_date	optional
dropoff_date	optional
pickup_time	optional
dropoff_time	optional
currency	optional
residence_country	optional
driver_age	optional
drop_query	optional
drop_place_id	optional
drop_city_id	optional
max_offers	optional
include_facets	optional
prefer_airport	optional

Try in playground →

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

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

Parameter	Required
query	required

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-22","dropoff_date":"2026-07-25","max_offers":40}'

Response shape

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