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.
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
orNY
, Australian state (see FAQ) or BrazilBR
, United KingdomUK
, IrelandIR
, ItalyIT
, SpainES
, IndiaIND
, MexicoMX
and New ZealandNZ
.
- 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
orxml
. Defaults tojson
.
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
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",
}