REST API Description

Our VINdecode API provides programmatic access to our VIN decode database.

Data Types

Lookup Tables

These tables are static. They don't change often, if at all.

Error Codes

        
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<VINquery version="1.0.0" report_type="EXTENDED" Date="5/28/2006">
  <VIN number="1FTRF02W24KXXXXXX" status="FAILED">
    <Message Key="3" Value="Invalid VIN number: This VIN number did not pass checksum test." />
  </VIN>
</VINquery>
        
    

Known Issues

• A single VIN returns data related to multiple trim levels.

Occasionally, information coded by the manufacturer in a submitted VIN may not be sufficient for our VIN decoding engine to narrow it down to a single trim level so all available records for that particular VIN will be returned. In this case, all available trim levels may have to be presented to end users so they can make a selection from those returned choices.

• A single trim level returns multiple transmissions, exterior colors, interior trims, ABS(Non-ABS |* 2-Wheel ABS |* 4-Wheel ABS) etc.

For instance, a decoded VIN may offer all exterior color choices that were available for a particular vehicle, but can't tell you what color the vehicle actually is - therefore all available color choices for the vehicle might have to be presented to end users so they can select the color or have the option to enter another color choice in case the vehicle was painted over.

* "|" is used as a delimiters or separator when a data item contains multiple choices.

Coding Examples

    const url="https://ws.vinquery.com/restxml.aspx?accesscode=YOUR_ACCESS_CODE&reportType=YOUR_REPORT_TYPE&vin=YOUR_VIN";

    //To fetch the XML data feed synchronously
    var parser = new DOMParser();
    var xhttp = new XMLHttpRequest();
    xhttp.open("GET", url, false);
    xhttp.send();
    xmlDoc = parser.parseFromString(xhttp.responseText,"text/xml");
    alert(xhttp.responseText);
    var output = "Model Year: " + xmlDoc.getElementsByTagName("Item")[0].getAttribute("Value") + "\n";
    output += "Make: " + xmlDoc.getElementsByTagName("Item")[1].getAttribute("Value") + "\n";
    output += "Model: " + xmlDoc.getElementsByTagName("Item")[2].getAttribute("Value") + "\n";
    ...
    alert(output);

    //To fetch the XML data feed asynchronously
    var parser = new DOMParser();
    var xhttp = new XMLHttpRequest();
    xhttp.open("GET", url, true);
    xhttp.send();
    xhttp.onreadystatechange = function () {
    if (this.readyState == 4 && this.status == 200) {      
        xmlDoc = parser.parseFromString(xhttp.responseText, "text/xml");
        alert(xhttp.responseText);
        var output = "Model Year: " + xmlDoc.getElementsByTagName("Item")[0].getAttribute("Value") + "\n";
        output += "Make: " + xmlDoc.getElementsByTagName("Item")[1].getAttribute("Value") + "\n";
        output += "Model: " + xmlDoc.getElementsByTagName("Item")[2].getAttribute("Value") + "\n";
        ...
        alert(output);
    }

    import xml.etree.ElementTree as ET
    import requests

    url = "https://ws.vinquery.com/restxml.aspx?accesscode=YOUR_ACCCESS_CODE&reportType=YOUR_REPORT_TYPE&vin=YOUR_VIN"
    response = requests.get(url)
    xml = ET.fromstring(response.content.decode('UTF-8'))

    output = "Model Year: " + xml[0][0].attrib['Model_Year'] + "\n"
    output += "Make: " + xml[0][0].attrib['Make'] + "\n"
    output += "Model: " + xml[0][0].attrib['Model'] + "\n"
    output += "Trim Level: " + xml[0][0].attrib['Trim_Level']
    ...
    print(output)

    ...
    using System.Net;
    using System.Xml.Linq;
        

    static void Main(string[] args)
    {
    String url = "https://ws.vinquery.com/restxml.aspx?accesscode=YOUR_ACCESS_CODE&reportType=YOUR_REPORT_TYPE&vin=YOUR_VIN";
    WebRequest request = WebRequest.Create(url);
    WebResponse response = request.GetResponse();

    using (Stream dataStream = response.GetResponseStream())
    {
        StreamReader stream = new StreamReader(dataStream);
        String responseString = stream.ReadToEnd();

        XElement root = XElement.Parse(responseString);

        IEnumerable<XElement> tests =
            from el in root.Elements("VIN").Elements("Vehicle").Elements("Item")
            where (string) el.Attribute("Key") != null
            select el;
        foreach (XElement el in tests)
            Console.WriteLine((string) el.Attribute("Key") + ": " + (string) el.Attribute("Value"));
    }
    response.Close();
    }

    ...
    import java.net.HttpURLConnection;
    import java.net.URL;
    

    public static void main(String[] args) {
	    final URL url = new URL(
	    "https://ws.vinquery.com/restxml.aspx?accesscode=YOUR_ACCESS_CODE&reportType=YOUR_REPORT_TYPE&vin=YOUR_VIN");
	    final HttpURLConnection con = (HttpURLConnection)url.openConnection();
	    con.setRequestMethod("GET");
                // use your favorite Java XML processing libraries for parsing, such as DOM Parser, SAX Parser, StAX Parser, 
                // JAXB, XStream, Jackson XML, Simple XML
                ...
	    con.disconnect();
    }

    <?php

    $response = file_get_contents('http://ws.vinquery.com/restxml.aspx?accesscode=YOUR_ACCESS_CODE&reportType=YOUR_REPORT_TYPE&vin=YOUR_VIN');
    $response = new SimpleXMLElement($response);
    $string = $response -> asXML();

    echo($string);

    foreach($response -> VIN -> Vehicle -> Item as $Item) {
        echo $Item['Key'], ': ', $Item['Value'], ' ';
    }

    ?>