Clearvin logo +1 (844) 268 – 5991
6807 NE 79th ct Ste B Portland OR 97218

VIN Decoder API

VIN Decoder API provides access to the ClearVin proprietary VIN decoded data. Our VIN decoder breaks the VIN number down into dozens of data points concerning the manufacture of the vehicle. We decode automobiles, SUVs, pickup trucks, heavy- and medium-duty trucks, motorcycles.

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" : “[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
{
    "status": "ok",
    "result": {
        "id": "3646F9E2",
        "vin": "5FNYF4H52BB038147",
        "report": {
            "decoder": {
                  "vin": "5FNYF4H52BB038147",
                  "make": "Honda",
                  "msrp": "$35,595 USD",
                  "trim": "EX-L 4WD 5-Spd AT",
                  "year": "2011",
                  "depth": "",
                  "model": "Pilot",
                  "style": "SPORT UTILITY 4-DR",
                  "tires": "245/65R17",
                  "width": "78.50 in.",
                  "4WdAwd": "Std.",
                  "engine": "3.5L V6 SOHC 24V",
                  "height": "72.70 in.",
                  "length": "190.90 in.",
                  "madeIn": "UNITED STATES",
                  "invoice": "",
                  "cargoNet": "N/A",
                  "cdPlayer": "Std.",
                  "extended": true,
                  "fuelTank": "21.00 gallon",
                  "absBrakes": "Std.",
                  "amFmRadio": "Std.",
                  "cdChanger": "Std.",
                  "driveline": "4WD",
                  "dvdPlayer": "N/A",
                  "fogLights": "Std.",
                  "rearWiper": "Std.",
                  "skidPlate": "N/A",
                  "subwoofer": "Std.",
                  "trackRear": "67.50 in.",
                  "wheelbase": "109.20 in.",
                  "tachometer": "Std.",
                  "trackFront": "67.70 in.",
                  "alloyWheels": "Std.",
                  "cargoLength": "",
                  "cargoVolume": "18.00 cu.ft.",
                  "cityMileage": "16 miles/gallon",
                  "firstAidKit": "N/A",
                  "frontAirDam": "Std.",
                  "leatherSeat": "Std.",
                  "maximumGvwr": "6096 lbs",
                  "rearHipRoom": "56.90 in.",
                  "rearLegroom": "38.50 in.",
                  "rearSpoiler": "N/A",
                  "steelWheels": "N/A",
                  "widthAtWall": "",
                  "chromeWheels": "N/A",
                  "driverAirbag": "Std.",
                  "frontHipRoom": "58.60 in.",
                  "frontLegroom": "41.40 in.",
                  "interiorTrim": "Beige Leather Interior | Black Leather Interior | Gray Leather Interior",
                  "keylessEntry": "Std.",
                  "powerSunroof": "Std.",
                  "powerWindows": "Std.",
                  "rearHeadroom": "39.80 in.",
                  "removableTop": "N/A",
                  "runFlatTires": "N/A",
                  "rustDistance": "Unlimited mile",
                  "rustDuration": "60 month",
                  "splashGuards": "Std.",
                  "standardGvwr": "6096 lbs",
                  "steeringType": "R&P",
                  "tiltSteering": "Std.",
                  "tripComputer": "Std.",
                  "basicDistance": "36,000 mile",
                  "basicDuration": "36 month",
                  "cruiseControl": "Std.",
                  "exteriorColor": "Alabaster Silver Metallic | Bali Blue Pearl | Crystal Black Pearl | Dark Cherry Pearl | Mocha Metallic | Polished Metal Metallic | Taffeta White",
                  "frontHeadroom": "39.30 in.",
                  "manualSunroof": "Std.",
                  "maximumTowing": "4500 lbs",
                  "navigationAid": "N/A",
                  "powerTrunkLid": "N/A",
                  "rearBrakeType": "Disc",
                  "runningBoards": "Opt.",
                  "cargoAreaCover": "Opt.",
                  "cassettePlayer": "N/A",
                  "frontBrakeType": "Disc",
                  "highwayMileage": "22 miles/gallon",
                  "intervalWipers": "Std.",
                  "maximumPayload": "1552 lbs",
                  "powerDoorLocks": "Std.",
                  "rearSpringType": "Coil",
                  "rearSuspension": "Ind",
                  "remoteIgnition": "N/A",
                  "standardTowing": "4500 lbs",
                  "airConditioning": "Std.",
                  "antiBrakeSystem": "4-Wheel ABS",
                  "deepTintedGlass": "Std.",
                  "frontCooledSeat": "N/A",
                  "frontHeatedSeat": "Std.",
                  "frontSideAirbag": "Std.",
                  "frontSpringType": "Coil",
                  "frontSuspension": "Ind",
                  "genuineWoodTrim": "N/A",
                  "groundClearance": "8.00 in.",
                  "optionalSeating": "",
                  "passengerAirbag": "Std.",
                  "passengerVolume": "152.70 cu.ft.",
                  "standardPayload": "1552 lbs",
                  "standardSeating": "8",
                  "tractionControl": "Std.",
                  "turningDiameter": "38.60 in.",
                  "curbWeightManual": "",
                  "rearShoulderRoom": "62.20 in.",
                  "telematicsSystem": "N/A",
                  "towHitchReceiver": "Std.",
                  "transmissionLong": "5-Speed Automatic",
                  "vehicleAntiTheft": "Std.",
                  "widthAtWheelwell": "",
                  "cargoAreaTiedowns": "Std.",
                  "destinationCharge": "$780 USD",
                  "frontShoulderRoom": "61.50 in.",
                  "fullSizeSpareTire": "N/A",
                  "rainSensingWipers": "N/A",
                  "transmissionShort": "5A",
                  "viNqueryVehicleId": "40831",
                  "powertrainDistance": "60,000 mile",
                  "powertrainDuration": "60 month",
                  "rearWindowDefogger": "Std.",
                  "tiltSteeringColumn": "Std.",
                  "automaticHeadlights": "Std.",
                  "curbWeightAutomatic": "4544 lbs",
                  "frontSplitBenchSeat": "N/A",
                  "heatedSteeringWheel": "N/A",
                  "lockingDifferential": "N/A",
                  "pickupTruckBedLiner": "N/A",
                  "productionSeqNumber": "038147",
                  "secondRowHeatedSeat": "N/A",
                  "secondRowSideAirbag": "N/A",
                  "tirePressureMonitor": "Std.",
                  "trunkAntiTrapDevice": "N/A",
                  "adjustableFootPedals": "N/A",
                  "childSafetyDoorLocks": "Std.",
                  "daytimeRunningLights": "Std.",
                  "electronicParkingAid": "Std.",
                  "frontPowerMemorySeat": "N/A",
                  "heatedExteriorMirror": "Std.",
                  "leatherSteeringWheel": "Std.",
                  "secondRowFoldingSeat": "Std.",
                  "automaticLoadLeveling": "N/A",
                  "sideHeadCurtainAirbag": "Std.",
                  "thirdRowRemovableSeat": "Std.",
                  "secondRowRemovableSeat": "Std.",
                  "secondRowSoundControls": "N/A",
                  "frontPowerLumbarSupport": "Std.",
                  "limitedSlipDifferential": "N/A",
                  "loadBearingExteriorRack": "Opt.",
                  "powerSlidingSideVanDoor": "N/A",
                  "voiceActivatedTelephone": "N/A",
                  "pickupTruckCargoBoxLight": "N/A",
                  "telescopicSteeringColumn": "Std.",
                  "towingPreparationPackage": "N/A",
                  "electronicBrakeAssistance": "Std.",
                  "lockingPickupTruckTailgate": "N/A",
                  "glassRearWindowOnConvertible": "N/A",
                  "slidingRearPickupTruckWindow": "N/A",
                  "steeringWheelMountedControls": "Std.",
                  "windDeflectorForConvertibles": "N/A",
                  "powerAdjustableExteriorMirror": "Std.",
                  "vehicleStabilityControlSystem": "Std.",
                  "driverMultiAdjustablePowerSeat": "Std.",
                  "highIntensityDischargeHeadlights": "N/A",
                  "frontSideAirbagWithHeadProtection": "N/A",
                  "passengerMultiAdjustablePowerSeat": "Std.",
                  "secondRowMultiAdjustablePowerSeat": "N/A",
                  "electrochromicExteriorRearviewMirror": "N/A",
                  "electrochromicInteriorRearviewMirror": "Std.",
                  "secondRowSideAirbagWithHeadProtection": "N/A",
                  "separateDriverFrontPassengerClimateControls": "Std."
            }
        }
    }
}