Vehicle Market Valuation Data API
ClearVin Vehicle Market Valuation API combines historical and real-time vehicle valuation data from multiple data aggregators to provide a comprehensive picture of the given vehicle value. Get market pricing estimates for new and used cars including retail, peak and average trade-in, loan values along with key vehicle specifications.
Please Note: Market Valuation data is only available for vehicles in their manufactured state and does not include any aftermarket changes to the vehicle, or changes in title state.
Authorization
You will need to use email and password to get the access token using this URL:POST https://www.clearvin.com/rest/vendor/login
Request must be from a registered IP address.The payload should be:
{ "email" : “exampl[email protected]”, "password": "11111111" }
Response
ELEMENT | DESCRIPTION | FORMAT |
---|---|---|
status | States whether the request was handled successfully, or ended with an error | String error or ok |
message | Contains details about the result if status is error | String |
token | JSON web token. The token expires in 300 minutes | String |
If email and password are correct the token will be returned response with token as follows:
{ "status": "ok", "token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
Report
After you receive this token you can use it to access reports using this URL:GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
To use this endpoint, you need to provide HTTP header with the supplied token as follows:Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Response
ELEMENT | DESCRIPTION | TYPE |
---|---|---|
status | States whether the request was handled successfully, or ended with an error | String error or ok |
message | Contains details about the result if status is error | String |
Report id | Contains current report id | String |
Report vin | Requested vin | String |
Report report | Contains full information about the vehicle | JSON object |
You can also receive reports in html view by using URL like this:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
And provide next HTTP headers:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
Auth success
Request
curl -X POST \ https://www.clearvin.com/rest/vendor/login \ -H 'Content-Type: application/json' \ -d '{ "email": "[email protected]", "password": "yourpassword" }
Response success
{ "status": "ok", "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
Response error
{ "status": "error", "message": "Wrong username or password" }
Report
Request
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ - H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ - H 'Content-Type: application/json'
Response success
{ "status": "ok", "result": { "id": "00CA168F", "vin": "WAUDG74F25N111998", "report": { "nada": { "modelYear": "2005", "make": "Audi", "model": "A6", "body": "Sedan 4D 3.2 AWD 3.2L V6", "averageMileage": "162500", "mileageAdjustment": "0", "adjustedCleanTrade": "2650", "adjustedAverageTrade": "1900", "adjustedRoughTrade": "1025", "adjustedCleanRetail": "4725", "adjustedLoan": "2400", "maxMileageAdj": "1325", "minMileageAdj": "-1060", "minAdjRetail": "420", "minAdjCleanTrade": "120", "minAdjAverageTrade": "120", "minAdjRoughTrade": "120", "minAdjLoan": "0", "fuelType": "Gas", "retail": "4725", "tradeIn": "2650", "roughTradeIn": "1025", "averageTradeIn": "1900", "loanValue": "2400", "uid": "200509150", "msrp": "40900", "tradeInValues": [] }, "previewImage": null } } }