KtemiaKtemia home
Search cars

Search cars

POST/cars/search

This call returns a searchToken. It does not return cars. An Austin week usually answers in 3–12 seconds while the search settles.

Country and currency

Send country to pick the market. Prices come back in that country’s native currency. GB returns GBP, DE returns EUR, US returns USD. Omit country and the market is the US, so prices are USD.

There is no currency field on this call. Sending one is rejected. You cannot ask for US prices in GBP, or UK prices in USD - the country decides the currency.

Pickup, dates, times

Send pickupLocation, pickupDate, and dropoffDate. Add dropoffLocation only when the car is returned somewhere else. Times default to 12:00; minutes must be 00 or 30.

pickupLocation is an id, not a name. Look it up with Search locations and send locationId.

When there is nothing to page

If there are no cars, the call returns 404 NO_RESULTS and no token. A date further than a year out, or an id that is not a pickup place, is the usual cause.

Cars from one booking site or rental company

Send providers to keep only the prices one or more booking sites sell, for example ["Expedia"]. Send agencies to keep only the cars of one or more rental companies, for example ["avis"], whichever site sells them. At Austin airport, both came back with 20 cars on page 1, every one from Expedia or Avis.

The ids come from the data. Run a search without a filter, then read availableFilters.bookingSites and availableFilters.agency on List results. Agency ids are lowercase codes such as hertz or enterprise. Up to 10 of each. Providers lists every booking site and rental company we have seen, and opens this page with the filter already in the examples.

Read more

The compare job for a pickup: car rental API. How the same search covers several sellers: car rental aggregator API.

Parameters

The body of the request.

pickupLocationstringRequired

A locationId from Search locations. A name is rejected.

dropoffLocationstring

A locationId when the car is dropped off somewhere else. Omit it for the same place.

pickupDatestringRequired

Pickup date, YYYY-MM-DD. Cannot be in the past. Searches are usually published under a year ahead.

dropoffDatestringRequired

Dropoff date, YYYY-MM-DD. Cannot be before pickupDate.

pickupTimestring

Pickup time, HH:MM. Minutes must be 00 or 30. Defaults to 12:00.

dropoffTimestring

Dropoff time, HH:MM. Minutes must be 00 or 30. Defaults to 12:00.

driverAgeinteger

Age of the driver, 18–99. Omit it to use the supplier default.

carClassstring

Keep only this class. Omit it to allow any class.

Possible values

small

Mini and compact cars.

medium

Intermediate cars.

large

Full-size cars.

suv

SUVs.

van

Vans and people carriers.

pickup

Pickup trucks.

luxury

Luxury cars.

convertible

Convertibles.

transmissionstring

Keep only this gearbox. Omit it to allow either.

Possible values

automatic

Automatic only.

manual

Manual only.

maxPriceinteger

Highest total price to return, as a whole number in the country’s native currency. Minimum is 1. Omit it for no price cap.

providersarray of strings

Keep only prices from these booking sites, for example ["Expedia"]. Use the id values from availableFilters.bookingSites on a previous results page. Up to 10. Omit it to allow every seller.

agenciesarray of strings

Keep only cars from these rental companies, for example ["avis"]. Use the id values from availableFilters.agency on a previous results page. Up to 10. Omit it to allow every agency.

sortBystring

How to order the results. Defaults to bestValue.

Possible values

bestValue

Default. Recommended order.

price

By total price.

rating

By desk score.

distance

By distance from the city centre.

sortOrderstring

Direction for sortBy. Defaults to asc.

Possible values

asc

Default. Lowest price, highest rating, or nearest desk first.

desc

The other direction.

priceModestring

Whether prices are totals or per day. Defaults to total.

Possible values

total

Default. Price for the whole hire.

perDay

Average daily price.

countrystring

ISO 3166-1 alpha-2 market. Prices come back in that country’s native currency - GB returns GBP, DE returns EUR, US returns USD. There is no separate currency field; sending currency is rejected. Omit country for US. Any other value is rejected.

Possible values59

USPrices in USD.
GBPrices in GBP.
DEPrices in EUR.
FRPrices in EUR.
ESPrices in EUR.
ITPrices in EUR.
NLPrices in EUR.
BEPrices in EUR.
ATPrices in EUR.
CHPrices in CHF.
IEPrices in EUR.
PTPrices in EUR.
GRPrices in EUR.
PLPrices in PLN.
CZPrices in CZK.
ROPrices in EUR.
SEPrices in SEK.
NOPrices in NOK.
DKPrices in DKK.
FIPrices in EUR.
TRPrices in TRY.
AEPrices in AED.
SAPrices in SAR.
ILPrices in ILS.
INPrices in INR.
JPPrices in JPY.
KRPrices in KRW.
HKPrices in HKD.
TWPrices in TWD.
SGPrices in SGD.
MYPrices in MYR.
THPrices in THB.
IDPrices in IDR.
PHPrices in PHP.
VNPrices in VND.
AUPrices in AUD.
NZPrices in NZD.
CAPrices in CAD.
MXPrices in MXN.
BRPrices in BRL.
ARPrices in ARS.
CLPrices in CLP.
COPrices in COP.
PEPrices in PEN.
UYPrices in USD.
PYPrices in USD.
BOPrices in USD.
ECPrices in USD.
VEPrices in USD.
CRPrices in USD.
PAPrices in USD.
GTPrices in USD.
HNPrices in USD.
NIPrices in USD.
SVPrices in USD.
DOPrices in USD.
PRPrices in USD.
ZAPrices in ZAR.
UAPrices in UAH.

Returns

A successful response, captured live.

                        {
  "searchToken": "eyJwIjoxLCJzIjoiMzY5Yjc0Yzc0NDI1NGYxYThjMWIyNGQ3NjgxMmZjMWUiLCJ2IjoxfQ",
  "expiresIn": 3600
}