docs / api / vin / plate-vin

Plate to VIN API

Convert U.S. license plate and state inputs into VIN-linked vehicle records through nationwide plate-to-VIN lookup requests. The API supports JSON and XML responses, API key authentication, and mock mode for safe integration testing.

GET

https://plate2vin.vinaudit.com/v1/licenselookup?

Request Parameters

Parameter

key

required

Example

YOUR_API_KEY_HERE

Description

Your VinAudit API key

Parameter

plate

required

Example

GHQ3084

Description

The vehicle's license plate number

Parameter

state

required

Example

Description

Two-letter state abbreviation

Parameter

format

optional

Example

Description

Either json (for JSON output; default) or xml (for XML output)

Parameter	Description	Example
keyrequired	Your VinAudit API key	YOUR_API_KEY_HERE
platerequired	The vehicle's license plate number	GHQ3084
staterequired	Two-letter state abbreviation	OH
formatoptional	Either json (for JSON output; default) or xml (for XML output)

Response Attributes

Field

VIN

Example

1C6SRFJT2NN300571

Description

The vehicle identification number

Field

error

Example

unauthorized_request

Description

One of: unauthorized_request, rate_limit_exceeded, billing_limit_exceeded, failed_request, missing_plate, missing_state, invalid_plate, invalid_state, no_data, upstream_error, or internal_error. See Error Responses for details. Blank if no error.

Field

success

Example

true

Description

If the request was a success

Field	Description	Example
VIN	The vehicle identification number	1C6SRFJT2NN300571
error	One of: unauthorized_request, rate_limit_exceeded, billing_limit_exceeded, failed_request, missing_plate, missing_state, invalid_plate, invalid_state, no_data, upstream_error, or internal_error. See Error Responses for details. Blank if no error.	unauthorized_request
success	If the request was a success	true

Example Request

HTTP

https://plate2vin.vinaudit.com/v1/licenselookup?

Example Response

JSON

JSON Format:
 {"success":true,"vin":"1C6SRFJT2NN300571"}

XML Format:
 <result>
<success>1</success>
<vin>1C6SRFJT2NN300571</vin>
</result>

Error Responses

Error Code	Description
`unauthorized_request`	The API key is invalid, or the account does not have access to Plate to VIN.
`rate_limit_exceeded`	The account has reached its allowed request or usage limit. Please retry later.
`billing_limit_exceeded`	The account has reached its billing limit or has insufficient prepaid balance.
`failed_request`	The request is missing a required parameter (such as the API key) or uses an unsupported format.
`missing_plate`	The plate parameter is missing.
`missing_state`	The state parameter is missing.
`invalid_plate`	The plate is longer than 10 characters.
`invalid_state`	The state is not a valid US state.
`no_data`	No VIN was found for this plate and state.
`upstream_error`	The data source timed out or returned no response. Please retry later.
`internal_error`	An unexpected server error occurred. Please retry later or contact support.

Ready to build?

Access the Market Listings and Market Values APIs with a free developer account. No credit card required.

Start Free Trial View API Docs