Plate Decoder DEPRECATED

This API is deprecated and will be removed in the future. Please use the Plate Decoder V2 API instead.

The Vehicle Plate Decoder API provides access to a library of vehicle's data based on the vehicle's registration/license plate number and state.

The Vehicle Plate Decoder API looks up the vehicle through the database for matches and returns the VIN, make, model and year among other attributes. It can be coupled with other APIs to become even more powerful. The state is a two letter abbreviation of one of the 50 states, or DC (District of Columbia), GU (Guam), PR (Puerto Rico) or VI (Virgin Islands).

International support includes the following countries: Australia, Brazil, United Kingdom, Ireland, Italy, Spain, India, Mexico and New Zealand.

GET/platedecoder

Vehicle Plate Decoder

This endpoint allows you to retrieve vehicle information based on license plates and registration numbers.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
plate
Type
string
Description
The vehicle registration number or license plate number.
Name
state
Type
string
Description
The two letter state code (US) such as CA or NY, Australian state (see FAQ) or Brazil BR, United Kingdom UK, Ireland IR, Italy IT, Spain ES, India IND, Mexico MX and New Zealand NZ.
Name
country
Type
string
Description
Australia AU
Optional for US.

Optional attributes

Name
format
Type
string
Description
The format of the response. One of json or xml. Defaults to json.

Response attributes

Name
vin
Type
string
Description
The vehicle identification number.
Name
success
Type
boolean
Description
Whether the plate decoder data has been retrieved.
Name
imageUrl
Type
string
Description
A stock photo of that general vehicle. (Use Images API for more control)
Name
assembly
Type
string
Description
Where the vehicle was assembled.
Name
Description
Type
string
Description
Vehicle description of make, model and trim.
Name
RegistrationYear
Type
string
Description
Year of the vehicle's registration.
Name
CarMake
Type
string
Description
The vehicle make.
Name
CarModel
Type
string
Description
The model of the vehicle.
Name
BodyStyle
Type
string
Description
The specific vehicle body style.
Name
EngineSize
Type
string
Description
The vehicle's engine size.

FAQ

Title
What plate can I use for testing?
▼
You may be use the following plate for test:
- Plate: 7XER187
- State: CA
Title
How can I search Australian vehicle registrations?
▼
For Australia use country=AU&state=NSW. The list of possible Australian states are:
- NSW (New South Wales),
- VIC (Victoria),
- QLD (Queensland incl. North Queensland),
- SA (South Australia),
- ACT (Canberra),
- NT (Northern Territory),
- TAS (Tasmania),
- WA (Western Australia)
Title
Is the Vehicle Plate Decoder API included in the free trial?
▼
No, The Vehicle Plate Decoder API is not included in the 7-day free trial. For more information visit our pricing page.

Request

GET

/platedecoder

curl -G https://api.carsxe.com/platedecoder \
  -d key=CARSXE_API_KEY \
  -d plate=7XER187 \
  -d state=CA

Response

{
  input: {
    plate: "7XER187",
    country: "",
    state: "CA",
  },
  Description: "Kia Forte LX",
  imageUrl: "https://api.carsxe.com/pic?image=@S2lhIEZvcnRlIExY",
  vin: "3KPFK4A78HE103497",
  BodyStyle: "Sedan 4D",
  RegistrationYear: "2017",
  EngineSize: "2.0L I4 MPI",
  CarMake: "Kia",
  success: true,
  CarModel: "Forte LX",
  assembly: "Mexico",
}