Vehicle Search

GET /api/vehicles/

Parameter Type Default Description
vin String Vehicle identification number to search by. Valid VIN is 17 characters long and does not include the letters I (i), O (o), or Q (q).
title String Title number.
plate String Vehicle license plate.
firstName String Owner's first name.
middleName String Owner's middle name.
lastName String Owner's last name
street String Owner's street address.
city String Owner's city.
state String Owner's state.
zip String Owner's zip code.
page Integer 1 Page number to navigate to. You may omit this parameter or use 1 for the initial query.
size Integer 25 Number of results to return per page. Default value is used when parameter is omitted.
Parameter Type Description
pageNumber Integer Current page number.
pageSize Integer Records per page.
totalResults Integer Total records found.
totalPages Integer Total number of pages.
matches Array Collection of matched records.
id String Record tracking identifier.
href String Hypermedia link to record details.
vin String Vehicle identifiction number.
year String Vehicle year.
make String Vehicle make.
class String Vehicle class.
plate Object
licensePlate String License plate number.
expirationYear String License plate expiration year.
title Object
title String Title number.
titleDate Date Title issue date.
owner Object
name String Owner's name.
city String Owner's city.
state String Owner's state.
zip String Owner's zip.
status String Current status: PREVIOUS OWNER or CURRENT OWNER.
suspendedCode String Suspended code: 'B' indicates suspended registration.
registrationStatus String Registration status: CURRENT, HISTRIC or TITLEONLY.
success Boolean Request status.
createdUtc DateTime Request timestamp. 
var http = require("http");
var options = {
  "method": "GET",
  "hostname": URL,
  "port": PORT,
  "path": "/api/vehicles/?vin=1J9TS5320BB541515",
  "headers": {
    "authorization": "Bearer [TOKEN FROM AUTHENTICATION API CALL]",
    "accept": "application/json",
    "cache-control": "no-cache",    
  }
};
var req = http.request(options, function (res) {
  var chunks = [];
  res.on("data", function (chunk) {
    chunks.push(chunk);
  });
  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});
req.end();

 var client = new RestClient(URL + "/api/vehicles/?vin=1J9TS5320BB541515");
var request = new RestRequest(Method.GET);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer [TOKEN FROM AUTHENTICATION API CALL]");
IRestResponse response = client.Execute(request);
                                                            
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
  .url(URL + "/api/vehicles/?vin=1J9TS5320BB541515")
  .get()
  .addHeader("authorization", "Bearer [TOKEN FROM AUTHENTICATION API CALL]")
  .addHeader("accept", "application/json")
  .addHeader("cache-control", "no-cache")
  .build();
Response response = client.newCall(request).execute();

                        var settings = {
  "async": true,
  "crossDomain": true,
  "url": URL + "/api/vehicles/?vin=1J9TS5320BB541515",
  "method": "GET",
  "headers": {
    "authorization": "Bearer [TOKEN FROM AUTHENTICATION API CALL]",
    "accept": "application/json",
    "cache-control": "no-cache",
  }
}
$.ajax(settings).done(function (response) {
  console.log(response);
});

                        setUrl(URL + '/api/vehicles/');
$request->setMethod(HTTP_METH_GET);
$request->setQueryData(array(
  'vin' => '1J9TS5320BB541515'
));
$request->setHeaders(array(  
  'cache-control' => 'no-cache',
  'accept' => 'application/json',
  'authorization' => 'Bearer [TOKEN FROM AUTHENTICATION API CALL]'
));
try {
  $response = $request->send();
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}

{
  "pageNumber": 1,
  "pageSize": 25,
  "totalResults": 2,
  "totalPages": 1,
  "matches": [
    {
      "vin": "1J9TS5320BB541515",
      "year": "11",
      "make": "TAK",
      "class": "TRAILER",
      "plate": {
        "licensePlate": "N/A",
        "expirationYear": "N/A"
      },
      "owner": {
        "name": "DOE JOHN",
        "city": "RAYTOWN",
        "state": "MO",
        "zip": "64133",
        "status": "PREVIOUS OWNER",
        "suspendedCode": "R"
      },
      "title": {
        "title": "ZKM61678",
        "titleDate": "01/12/2016"
      },
      "registrationStatus": "TITLEONLY",
      "href": "details/587151ad48bfcd3a144a4c0d/1J9TS5320BB541515/21424714/45790627/",
      "id": "587151ad48bfcd3a144a4c0d"
    },
    {
      "vin": "1J9TS5320BB541515",
      "year": "11",
      "make": "TAK",
      "class": "TRAILER",
      "plate": {
        "licensePlate": "12E7LS",
        "expirationYear": "2018"
      },
      "owner": {
        "name": "MILES DAVID",
        "city": "HANNIBAL",
        "state": "MO",
        "zip": "63401",
        "status": "CURRENT OWNER",
        "suspendedCode": "R"
      },
      "title": {
        "title": "456KM021",
        "titleDate": "01/12/2016"
      },
      "registrationStatus": "CURRENT",
      "href": "details/587151ad48bfcd3a144a4c0e/1J9TS5320BB541515/21424714/45827431/59334649",
      "id": "587151ad48bfcd3a144a4c0e"
    }
  ],
  "success": true,
  "createdUtc": "2017-01-07T20:38:05.1887394Z"
}


<Result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<PageNumber>1</PageNumber>
<PageSize>25</PageSize>
<TotalResults>2</TotalResults>
<TotalPages>1</TotalPages>
<Matches>
    <Match xsi:type="Vehicle">
        <Id>587162a948bfcd3a144a4c11</Id>
        <Vin>1J9TS5320BB541515</Vin>
        <Year>11</Year>
        <Make>TAK</Make>
        <Class>TRAILER</Class>
        <Plate>
            <PlateNumber>N/A</PlateNumber>
            <ExpirationYear>N/A</ExpirationYear>
        </Plate>
        <Owner>
            <Name>DOE JOHN</Name>
            <City>RAYTOWN</City>
            <State>MO</State>
            <Zip>64133</Zip>
            <Status>PREVIOUS OWNER</Status>
            <SuspendedCode>R</SuspendedCode>
        </Owner>
        <Title>
            <TitleNumber>ZKM61678</TitleNumber>
            <TitleDate>01/12/2016</TitleDate>
        </Title>
        <RegistrationStatus>TITLEONLY</RegistrationStatus>
        <DetailsUrl>details/587162a948bfcd3a144a4c11/1J9TS5320BB541515/21424714/45790627/</DetailsUrl>
    </Match>
    <Match xsi:type="Vehicle">
        <Id>587162a948bfcd3a144a4c12</Id>
        <Vin>1J9TS5320BB541515</Vin>
        <Year>11</Year>
        <Make>TAK</Make>
        <Class>TRAILER</Class>
        <Plate>
            <PlateNumber>12E7LS</PlateNumber>
            <ExpirationYear>2018</ExpirationYear>
        </Plate>
        <Owner>
            <Name>MILES DAVID</Name>
            <City>HANNIBAL</City>
            <State>MO</State>
            <Zip>63401</Zip>
            <Status>CURRENT OWNER</Status>
            <SuspendedCode>R</SuspendedCode>
         </Owner>
        <Title>
            <TitleNumber>456KM021</TitleNumber>
            <TitleDate>01/12/2016</TitleDate>
        </Title>
        <RegistrationStatus>CURRENT</RegistrationStatus>
        <DetailsUrl>details/587162a948bfcd3a144a4c12/1J9TS5320BB541515/21424714/45827431/59334649</DetailsUrl>
    </Match>
</Matches>
<Success>true</Success>
<CreatedUtc>2017-01-07T21:50:33.9086917Z</CreatedUtc>
</Result>

Vehicle Details

GET /api/vehicles/details/

The response from vehicle search includes relative hyperlink to the record details resource. Similar to vehicle search, include your authentication token and consume the resource specified in the href JSON tag or DetailsUrl XML tag. The relative resource path should look similar to /api/vehicles/details/587162a948bfcd3a144a4c11/1J9TS5320BB541515/21424714/45790627/
{
  "searchId": "5870053a66b5510754dc42a5",
  "vin": "1J9TS5320BB541515",
  "year": "2011",
  "make": "TAK",
  "class": "TRAILER",
  "plate": {
    "licensePlate": "12E7LS",
    "expirationYear": "2018",
    "type": "TRAILER",
    "issueDate": "1/4/2016",
    "expirationDate": "12/31/2018",
    "county": "MARION",
    "wgtSeat": "UNDER 6,000 LBS",
    "operationZone": "Not required or not known",
    "surrenderFlag": "N",
    "duplicateFlag": "N"
  },
  "owner": {
    "name": "DOE JOHN",
    "street": "PO BOX 1000",
    "city": "RAYTOWN",
    "state": "MO",
    "zip": "64133"
  },
  "title": {
    "title": "ZKM61678",
    "titleType": "Original",
    "purchasePrice": "Not Available",
    "purchaseTax": "N/A",
    "dealerNumber": "Not Available",
    "brandCode": "N/A",
    "issueDate": "1/12/2016",
    "exempt": "No",
    "mileage": "Not Available",
    "odometerStatus": "Mileage ok",
    "applicationDate": "1/11/2016",
    "purchaseDate": "1/2/2016"
  },
  "registrationStatus": "CURRENT",
  "newUsedFlag": "Used out-state",
  "bodyStyle": "5THWL",
  "series": "Not Available",
  "horsePower": "Not Available",
  "cylinders": "Not Available",
  "fuelType": "Other",
  "liens": [
    {
      "type": "Primary",
      "name": "HOMEBANK",
      "street": "400 S MAIN ST",
      "city": "PALMYRA",
      "state": "MO",
      "zip": "63461",
      "date": "12/31/2015"
    },
    {
      "type": "MailTo",
      "name": "DOE JOHN",
      "street": "PO BOX 1000",
      "city": "RAYTOWN",
      "state": "MO",
      "zip": "64133"
    }
  ],
  "id": "58716b8248bfcd3a144a4c17"
}
                                                            

<Result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Id>587169e448bfcd3a144a4c15</Id>
    <SearchId>5870053a66b5510754dc42a5</SearchId>
    <Vin>1J9TS5320BB541515</Vin>
    <Year>2011</Year>
    <Make>TAK</Make>
    <Class>TRAILER</Class>
    <Plate>
        <PlateNumber>12E7LS</PlateNumber>
        <ExpirationYear>2018</ExpirationYear>
        <PlateType>TRAILER</PlateType>
        <IssueDate>1/4/2016</IssueDate>
        <ExpirationDate>12/31/2018</ExpirationDate>
        <County>MARION</County>
        <WgtSeat>UNDER 6,000 LBS</WgtSeat>
        <OperationZone>Not required or not known</OperationZone>
        <SurrenderFlag>N</SurrenderFlag>
        <DuplicateFlag>N</DuplicateFlag>
    </Plate>
    <Owner>
        <Name>DOE JOHN</Name>
        <Street>PO BOX 1000</Street>
        <City>RAYTOWN</City>
        <State>MO</State>
        <Zip>64133</Zip>
    </Owner>
    <Title>
        <TitleNumber>ZKM61678</TitleNumber>
        <TitleType>Original</TitleType>
        <PurchasePrice>Not Available</PurchasePrice>
        <PurchaseTax>N/A</PurchaseTax>
        <DealerNumber>Not Available</DealerNumber>
        <BrandCode>N/A</BrandCode>
        <IssueDate>1/12/2016</IssueDate>
        <Exempt>No</Exempt>
        <Mileage>Not Available</Mileage>
        <OdometerStatus>Mileage ok</OdometerStatus>
        <ApplicationDate>1/11/2016</ApplicationDate>
        <PurchaseDate>1/2/2016</PurchaseDate>
    </Title>
    <RegistrationStatus>CURRENT</RegistrationStatus>
    <NewUsedFlag>Used out-state</NewUsedFlag>
    <BodyStyle>5THWL</BodyStyle>
    <Series>Not Available</Series>
    <HorsePower>Not Available</HorsePower>
    <Cylinders>Not Available</Cylinders>
    <FuelType>Other</FuelType>
    <Liens>
        <Lien>
            <Type>Primary</Type>
            <Name>HOMEBANK</Name>
            <Street>400 S MAIN ST</Street>
            <City>PALMYRA</City>
            <State>MO</State>
            <Zip>63461</Zip>
            <Date>12/31/2015</Date>
        </Lien>
        <Lien>
            <Type>MailTo</Type>
            <Name>DOE JOHN</Name>
            <Street>PO BOX 1000</Street>
            <City>RAYTOWN</City>
            <State>MO</State>
            <Zip>64133</Zip>
        </Lien>
    </Liens>
</Result>