Search
K
Vehicle History Verification (NMVTIS) - Sandbox

Vehicle History Verification (NMVTIS)

1.0.0OAS 3.0

Retrieves title, brand, and historical record data for a vehicle from the National Motor Vehicle Title Information System (NMVTIS), including prior title status, odometer readings, and salvage/junk brands where reported.

API Base URL
  • Server 1:https://api-test.vitu.com/one/nmvtis/api/v1
Security
oneVituOauth (oauth2)

OAuth 2.0 client credentials grant https://tools.ietf.org/html/rfc6749#section-4.4

Additional Information
Contact ([email protected])

Inquiry

Create inquiry

Creates NMVTIS lookup inquiry.

post
https://api-test.vitu.com/one/nmvtis/api/v1/inquiry

Headers

x-location-idinteger

VITU Location ID

x-on-behalf-user-idinteger

Id of the user on behalf of whom the request is being made

Body

application/json

InquiryRequestDTO

refNumberstring(uuid)required

Unique reference number for the inquiry

<= 36 characters

vinstringrequired

Match pattern:^[A-HJ-NPR-Z0-9]{17}$

<= 17 characters

stockNumberstring

<= 500 characters

Response

application/json

OK

InquiryIdResponseDTO

inquiryIdinteger

Callbacks

post
{$request.query.callbackUrl}

Callback Response

200

OK

post/inquiry

Body

{ "refNumber": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "vin": "9C1XPFWFTDG603GLA", "stockNumber": "12345" }
 
application/json
callback sample
Callback Body
Callback Response
200

Load inquiry

Load inquiry.

get
https://api-test.vitu.com/one/nmvtis/api/v1/inquiry/id/{inquiryId}

Path Parameters

inquiryIdstringrequired

<= 36 characters

Response

application/json

OK

InquiryResponseDTO

inquiryIdinteger
refNumberstring(uuid)

<= 36 characters

vinstring

<= 17 characters

userIdinteger
locationIdinteger
stockNumberstring

<= 500 characters

errorstring

<= 500 characters

processedDatestring(date-time)

<= 500 characters

get/inquiry/id/{inquiryId}
 
application/json

Load inquiry

Load inquiry.

get
https://api-test.vitu.com/one/nmvtis/api/v1/inquiry/refNumber/{refNumber}

Path Parameters

refNumberstringrequired

<= 36 characters

Response

application/json

OK

InquiryResponseDTO

inquiryIdinteger
refNumberstring(uuid)

<= 36 characters

vinstring

<= 17 characters

userIdinteger
locationIdinteger
stockNumberstring

<= 500 characters

errorstring

<= 500 characters

processedDatestring(date-time)

<= 500 characters

get/inquiry/refNumber/{refNumber}
 
application/json