How to Use Car Rental Search Filters
The Search Rentals endpoint supports a powerful filter system that lets you narrow results by vehicle characteristics, price, and more. Filters are passed as a single filter query parameter using a structured syntax.
Filter Syntax
Each filter expression follows the format:
To apply multiple filters, separate them with commas:
filter=price:lte:100,vehicletype:in:SUV,transmissiontype:eq:Automatic
All filters are applied together as AND conditions. A result must match every filter to be included.
Available Filter Fields
Price
| Filter | Description | Example |
|---|
price:lte:{amount} | Maximum price (less than or equal). | price:lte:150 |
price:gte:{amount} | Minimum price (greater than or equal). | price:gte:50 |
Combine both to define a price range:
filter=price:gte:50,price:lte:150
Vehicle Brand
| Filter | Description | Example |
|---|
rentalcarbrand:in:{brands} | Filter by one or more rental companies. | rentalcarbrand:in:Hertz |
Use the in operator with pipe-separated values for multiple brands:
filter=rentalcarbrand:in:Hertz|Enterprise|Avis
Passenger Capacity
| Filter | Description | Example |
|---|
passengerquantity:eq:{count} | Exact number of passengers. | passengerquantity:eq:5 |
passengerquantity:gte:{count} | Minimum number of passengers. | passengerquantity:gte:4 |
Baggage Capacity
| Filter | Description | Example |
|---|
baggagequantity:eq:{count} | Exact baggage capacity. | baggagequantity:eq:2 |
baggagequantity:gte:{count} | Minimum baggage capacity. | baggagequantity:gte:3 |
Door Count
| Filter | Description | Example |
|---|
doorcount:gte:{count} | Minimum number of doors. | doorcount:gte:4 |
Transmission Type
| Filter | Description | Example |
|---|
transmissiontype:eq:{type} | Filter by transmission type. | transmissiontype:eq:Manual |
Common values: Manual, Automatic.
Fuel Type
| Filter | Description | Example |
|---|
fueltype:eq:{type} | Filter by fuel type. | fueltype:eq:Petrol |
Common values: Petrol, Diesel, Electric, Hybrid.
Drive Type
| Filter | Description | Example |
|---|
drivetype:eq:{type} | Filter by drive type. | drivetype:eq:4WD |
Common values: 2WD, 4WD, AWD.
Air Conditioning
| Filter | Description | Example |
|---|
airconditioning:eq:{val} | Filter by air conditioning status. | airconditioning:eq:true |
Vehicle Type
| Filter | Description | Example |
|---|
vehicletype:in:{types} | Filter by one or more vehicle types. | vehicletype:in:SUV |
Common values: Sedan, SUV, Van, Convertible, Wagon, Pickup, Coupe.
Use pipe-separated values for multiple types:
filter=vehicle_type:in:SUV|Van
Vehicle Size
| Filter | Description | Example |
|---|
vehiclesize:in:{sizes} | Filter by one or more vehicle sizes. | vehiclesize:in:Standard |
Common values: Mini, Economy, Compact, Standard, Full-size, Premium, Luxury.
Use pipe-separated values for multiple sizes:
filter=vehicle_size:in:Standard|Full-size|Premium
Vehicle Model
| Filter | Description | Example |
|---|
vehiclemodel:eq:{model} | Exact model match. | vehiclemodel:eq:Toyota Camry |
vehiclemodel:in:{models} | Match one or more models. | vehiclemodel:in:Toyota Camry | Honda Accord |
Sorting
Use the sort query parameter alongside filters:
| Value | Description |
|---|
distance | Sort by proximity to the search coordinates (nearest first). |
price | Sort by total price (lowest first). |
GET /cars/api/v2/rentals?...&sort=price&filter=vehicle_type:in:SUV
Pagination with Filters
Filters work seamlessly with pagination. The page and limit parameters apply after filters:
GET /cars/api/v2/rentals?...&filter=price:lte:100&sort=price&page=1&limit=10
Complete Example
Search for automatic SUVs with at least 5 seats under $200/day, sorted by price:
HTTP
GET /cars/api/v2/rentals?country=US&pickupdate=2026-06-15T10:00:00&returndate=2026-06-20T10:00:00&pickuptype=geo&returntype=geo&pickupcode=40.7128,-74.006&returncode=40.7128,-74.006¤cy=USD&sort=price&filter=vehicletype:in:SUV,transmissiontype:eq:Automatic,passenger_quantity:gte:5,price:lte:200
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Tips
- Start broad, then narrow. Run an initial search without filters to see what is available, then apply filters to refine results.
- Combine sorting with filters for the best user experience. For example, filter by
vehicle_type:in:SUV and sort by price. - Use
gte for capacity fields rather than eq when the user needs "at least" a certain number of seats or bags. - Filter values are case-sensitive. Use the exact casing shown in the tables above (e.g.,
Manual, not manual).