CarsXE Vehicle Plate Decoder

The CarsXE Vehicle Plate Decoder API returns detailed vehicle information using a license or registration plate number and the corresponding region code (country or state). Through CarsXE integration, it provides essential attributes such as VIN, make, model, year, trim, body style, engine size, and more and other vehicle attributes through CarsXE integration.

Base Path

GET https://api.marketcheck.com/v2/carsxe/plate-decoder/{plate}

Path Parameters:

• plate: Vehicle registration/license plate number to decode.

The following example demonstrates a basic request to the CarsXE Vehicle Plate Decoder API:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/carsxe/plate-decoder/7XER187',
  params: {api_key: 'YOUR_API_KEY', country: 'US', state: 'CA'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Request

The CarsXE Vehicle Plate Decoder API provides access to vehicle information using license plate lookup.

Parameters

Available parameters for plate decoder requests:

Required Parameters

The following parameters are required for plate decoder requests:

• plate - Vehicle registration/license plate number (provided in URL path)
  • Must be a valid license plate format
  • Case-insensitive string
• country - Two-letter ISO 3166-1 alpha-2 country code
  • Must be exactly two characters (e.g., "US", "CA")
• state - Two-letter state/province code
  • Required for US and Canada plates only
  • Must be exactly two characters (e.g., "CA", "TX", "ON")

State Codes Reference

United States (US)

Canada (CA)

Response

The CarsXE Vehicle Plate Decoder API returns vehicle identification information for the specified license plate in a structured JSON format.

Schema

interface Response {
  success: boolean; // Indicates if the lookup was successful
  input: {
    plate: string; // Original license plate number
    state: string; // State/province code used in lookup
    country: string; // Country code used in lookup
  };
  description: string; // Vehicle description summary
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model name
  trim: string; // Trim level
  vin: string; // Vehicle Identification Number
  style: string; // Body style description
  year: string; // Model year
  registration_year: string; // Registration year
  engine_size: string; // Engine size and configuration
  assembly: string; // Country/location of assembly
  fuel_type: string; // Fuel type
  color: string; // Vehicle color
  body_style: string; // Body style category
  engine: string; // Engine description
  drive_type: string; // Drivetrain type
  transmission: string; // Transmission type
}

Success Response

• 200 OK - Returns a JSON object containing vehicle information for the license plate
  • Includes success status and original input parameters
  • Contains comprehensive vehicle details including VIN, make, model, year, and specifications
  • Provides detailed vehicle attributes like engine, transmission, and assembly information

Error Response

Error Response Format

Most error responses follow this structure, except for 502 and 503 errors

{
  "code": <HTTP status code>,
  "message": "<Error message describing the issue>"
}

Use Cases & Examples

License Plate Lookup

Use the CarsXE Vehicle Plate Decoder to identify vehicles using license plate information. This is useful for insurance claims, law enforcement, and vehicle identification purposes.

Example:

Here we're looking up a vehicle by license plate number:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/carsxe/plate-decoder/7XER187',
  params: {api_key: 'YOUR_API_KEY', country: 'US', state: 'CA'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

See Also

• AutoRecalls
• Enhanced VIN Decoder
• VINData AAMVA Reports