Car Listings API

Guidance and examples for accessing the Car Listings API

The Car Listings API allows you to search Expedia car inventory by date, pickup, and drop-off location to return a listing of available cars for hire.

Endpoint

Method	Endpoint
GET	https://apim.expedia.com/cars/listings

Required Headers

Key:	Expedia API key
Authorization:	Expedia API Authorization String
Accept:	application/vnd.exp-car.v3+json
Partner-Transaction-Id:	Partner TransactionID String

Optional Headers

Accept-Encoding:	gzip More info on gzip

Next Steps

Deeplink customer to Expedia website where they can book selected car.
Get more information about a specific offer via the Car Details API.

Example of Search Request

Search with Airport

https://apim.expedia.com/cars/listings?pickup.airport=SEA&dropOff.airport=LAS&pickupTime=2021-06-10T10:00&dropOffTime=2021-06-10T16:30}

Search with Geolocation and Links

https://apim.expedia.com/cars/listings?&pickupTime=2021-06-26&dropOffTime=2021-06-28T15:30&pickup.geoLocation=47.61212,-122.332279&dropOff.address=1919+5Th+Avenue%2CSeattle&pickup.radius=8&unit=KM&links=WS,AD}

Search with Discount

https://apim.expedia.com/cars/listings?pickup.airport=LAS&pickupTime=2021-06-10T09:00&dropOffTime=2021-06-16T10:00&discount1.supplier=Hertz&discount1.type=CorpDiscount&discount1.code=50075&suppliers=Hertz

Error Codes

Common Error Codes

HTTP Status Code	Error Code	Error Message
500	APPLICATION_ERROR	Application error.
400	INVALID_ACCEPT	Accept is either missing or invalid. Please provide a correct Accept as following: Accept:application/ vnd.exp-<product>.<version>+<format> (product={car,flight,hotel},version={v3},format={json}).
400	INVALID_ACCEPT	Only one Accept is allowed.
400	INVALID_PARTNER_TRANSACTION_ID	Partner-Transaction-Id is missing.
400	INVALID_PARTNER_TRANSACTION_ID	Only one Partner-Transaction-Id is allowed.
400	INVALID_CLIENT_KEY	Invalid client key: [ client key value ].
400	INVALID_CLIENT_KEY	Only one Key is allowed.
400	INVALID_DRIVER_AGE	Invalid driver age. The value should be a number greater than 0.
400	INVALID_DRIVER_AGE	Invalid driver age. Allowed value is between [ age ] and [ age ].
400	TOO_MANY_SUPPLIERS	Too many suppliers. Please specify [ number ] or fewer suppliers.
400	INVALID_SUPPLIERS	Invalid suppliers. Invalid values are: [ supplier names ].
400	INVALID_CAR_CLASSES	Invalid car class. Invalid values are: [ car class names].
400	TOO_MANY_CAR_CLASSES	Too many car classes. Please specify [ number ] or fewer car classes.
400	INVALID_SORT_TYPE	Invalid sort type. Allowed values are: [ list of sort types].
400	INVALID_SORT_ORDER	Invalid sort order. Allowed values are: [ list of sort order values ].
400	INVALID_SORT	The sortType or sortOrder is missing.
400	INVALID_LIMIT	Invalid limit. The value should be an Integer greater than 0.
400	INVALID_DISCOUNT_SUPPLIER	Invalid discount supplier. Invalid value is: [ value].
400	INVALID_DISCOUNT_TYPE	Invalid discount type. Allowed values are: [ value ].
400	INVALID_DISCOUNTS_CODE	Invalid discount code. Invalid value is: [ discount code value ].
400	DISCOUNT_SUPPLIER_MISMATCH_WITH_FILTER_SUPPLIERS	Invalid discount supplier. Discount supplier should be included in filter suppliers. Invalid values are: [ value ]
400	INVALID_TRANSMISSIONS	Invalid transmissions.
400	INVALID_AIR_CONDITIONING	Invalid air conditioning. Allowed value should be true or false.
400	INVALID_CAR_TYPES	Invalid car types.
400	PICKUP_REQUIRED	Please specify one pickup.
400	MULTIPLE_PICKUP	Only one pickup is allowed.
400	INVALID_PICKUP_AIRPORT	Invalid pickup airport. The value should be 3 alphaNum characters.
400	EMPTY_PICKUP_CITY	Pickup city is empty.
400	EMPTY_PICKUP_ADDRESS	Pickup address is empty.
400	MULTIPLE_DROP_OFF	Only one drop off is allowed.
400	INVALID_DROP_OFF_AIRPORT	Invalid drop off airport. The value should be 3 alphaNum characters.
400	EMPTY_DROP_OFF_CITY	Drop off city is empty.
400	EMPTY_DROP_OFF_ADDRESS	Drop off address is empty.
400	INVALID_UNIT	Invalid unit. Allowed values are KM and MI.
400	INVALID_PICKUP_OR_DROP_OFF_DATETIME	Pickup or drop off datetime is either missing or invalid.
400	PICKUP_OR_DROP_OFF_DATETIME_OUT_OF_RANGE	Invalid pickup or drop off date. Valid dates range from the current date to [ number ] days in the future.
400	DROP_OFF_DATETIME_LESS_OR_EQUAL_PICKUP_DATETIME	Drop off datetime must occur after pickup datetime.
400	SEARCH_WINDOW_EXCEED_UPPER_LIMIT	Search window is too large. Maximum length of rental is [ number ] days.
400	SEARCH_WINDOW_UNDER_LOWER_LIMIT	The drop off datetime should occur at least [ number ] hours after the pickup datetime.
400	INVALID_PICKUP_GEOLOCATION	Pickup geoLocation is either missing or invalid.
400	INVALID_PICKUP_GEOLOCATION_LATITUDE	Pickup geoLocation latitude is either missing or invalid, Please specify values in the range[ value ] and [ value ].
400	INVALID_PICKUP_GEOLOCATION_LONGITUDE	Pickup geoLocation longitude is either missing or invalid, Please specify values in the range [ value ] and [ value ].
400	INVALID_DROP_OFF_GEOLOCATION	Drop off geoLocation is either missing or invalid.
400	INVALID_DROP_OFF_GEOLOCATION_LATITUDE	Drop off geoLocation latitude is either missing or invalid, Please specify values in the range [ value ] and [ value ].
400	INVALID_DROP_OFF_GEOLOCATION_LONGITUDE	Drop off geoLocation longitude is either missing or invalid, Please specify values in the range [ value ] and [ value ].
400	INVALID_PICKUP_RADIUS	The pickup radius should be an Integer greater than 0.
400	INVALID_DROP_OFF_RADIUS	The drop off radius should be an Integer greater than 0.
400	INVALID_REQUEST_PARAMETERS	Invalid request parameters.
400	INVALID_PICKUP_OR_DROPOFF_LOCATION	Invalid pickup or dropoff location.
400	INVALID_LOCALE	Invalid locale. The locale should be two-letter language code and two-letter region code connected with '_'.
200	INVALID_COUPON_CODE	The Coupon Code '[ coupon code ]' is unavailable, but we found other rates for you.
200	INVALID_CORPORATE_DISCOUNT_CODE	The Corporate Discount Code '[ corporate discount code ]' is unavailable, but we found other rates for you.
200	NO_RESULT_FOUND	Sorry, your query completed successfully, but did not return any inventory. Please adjust your search parameters and try again.
200	DISCOUNT_CODE_NOT_APPLICABLE	We didn't find any results that matched your discount code and rental car company, but we did find other options available at this location.
200	INVALID_SUPPLIERS	Invalid suppliers. Invalid values are: [ supplier names ].
200	UNSUPPORTED_LOCALE	The requested locale is not supported.

Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.