VIN Decoder API

Get unlimited access to our VIN decode API. Our VIN decoder API offers a cost-effective and seamless integration of our VIN decoding database into your products, services, or solutions. We break the VIN number to provide you with extensive data points related to the vehicle's manufacturing details. This includes essential information like the vehicle's year, make, model, trim level, technical VIN specs, and standard features embrassing up to 150 parameters. Our vehicle database covers North American (U.S. and Canada) VIN codes for automobiles, SUVs, pickup trucks, heavy- and medium-duty trucks, and motorcycles, spanning from 1981 to 2023, with daily updates to ensure accuracy and relevance.

VIEW DEMO

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": "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."
            }
        }
    }
}