The Vehicle History API allows you to access historical lead listing data from a variety of used car marketplaces. This API requires authentication and an appropriate license attached to it.
The Endpoint operates on a tiered system of queries:
VIN - The first initial call can be made to VIN + Region. However, if VIN does not return any history information, the following data is required as a fallback.
Year
Make
Model
Registration
It is recommended to provide all available data points when doing a Vehicle History call, only use VIN if no other data is available.
Title
Parameter
Example
Year
year
2019
Make
make
Volkswagen
Model
model
Polo
Registration Plate
registration_plate
BMT038
State
state
VIC
Vin
VIN
KL3TA48E9CB053071
The Make, Model fields are format-sensitive and rely on AutoGrabs Vehicle Search or ID lookup formatting. If using unsupported make and model descriptions, the vehicle history will not be returned when otherwise it could have been using the correct formatting.
Example
For example, if you were to use all available identifiers, your request would resemble the request below.
Currently, we support the price_changes feature that will show you fluctuations in the price. Passing this feature will return upward on downward movements in the listings' price.
Contact your sales rep to understand your commercial rate card for each feature.
Listing Sources
The listing_sources feature will return a unique array of listing sources where the vehicle has been posted, URLs for each historical listing and the primary description of the vehicle from the lead listing.
Note that the URLs may not always be active if the vehicle has already been delisted from the marketplace.
The listing_images feature will return an array of URLs to the 5 primary listing images the AutoGrab platform has associated with the vehicle. If there is not images available an empty array will be returned
It is expected that the external system download and store the images as part of the initial call. AutoGrab cannot guarantee the availability of these images for long term URL storage.
