Build your first integration.

Your first API request

Create an account, copy the credential shown once, and place it in a server-side environment variable or secrets manager.

Decode a vehicle

Send a valid 17-character VIN and your bearer credential. VINs are normalized to uppercase and cannot contain I, O, or Q.

                
curl --request GET "https://autodealer.dev/api/service/vin/1HGCM82633A004352/json"
    --header "Authorization: Bearer $AUTODEALER_API_KEY" 
    --header "Accept: application/json"
                
            

                
$.ajax({
    url: "/api/service/vin/1HGCM82633A004352/json",
    headers: { Authorization: "Bearer " + apiKey },
    dataType: "json"
}).done(function (vehicle) {
    console.log(vehicle);
});
                
<           

                
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
var result = await client.GetStringAsync("api/service/vin/1HGCM82633A004352/json");
                
            

Render the HTML vehicle report

Add one div with the VIN and your secure server-proxy URL. The widget requests the self-styled HTML fragment and renders the complete vehicle report inside that div.

                
<div id="vehicle-report"
    data-autodealer-vin-report
    data-api-key="ad_live_demo.keysecret"
    data-vin="1HGCM82633A004352"
    data-loading-text="Loading vehicle details...">
</div>

<script src="https://autodealer.dev/Scripts/autodealer-vin-report.js"></script>

VIN Decode endpoints

Response formats

VIN routes use explicit JSON, XML, and HTML format suffixes so clients always receive a predictable media type.