---
title: "US Vehicle Plate Decoder"
method: GET
path: "/v1/us-platedecoder"
tags: ["Plate Decoder"]
---

# US Vehicle Plate Decoder

`GET /v1/us-platedecoder`

Look up a US vehicle by license plate number and state. Returns the
VIN, year, make, model, trim, engine, body style, transmission, drive
type, fuel type and exterior color. Optionally decodes the VIN to
include the full vehicle specifications object. Accepts plates from all
50 US states, the District of Columbia (DC) and Puerto Rico (PR).

This endpoint is **not** available on the free Sandbox tier.

## Query parameters

- `plate` string, required
- `state` string, required
- `decodeVIN` 'true' | '1'

## Response `200`

Plate decoded successfully.

- object
  - `success` boolean
  - `input` object
    - `plate` string
    - `state` string
  - `vin` string
  - `year` string
  - `make` string
  - `model` string
  - `trim` string
  - `description` string
  - `engine_size` string
  - `body_style` string
  - `transmission` string
  - `drive_type` string
  - `fuel_type` string
  - `color` string
  - `vehicle_specs` SpecsResponse — Generic success envelope. Endpoint-specific payload fields appear at the top level alongside these common fields.
    - `success` boolean
    - `input` object — Echo of the input parameters specified by the query.
    - `timestamp` string
    - `attributes` object — A map of specifications about the VIN (year, make, model, trim, style, type, size, category, made_in, doors, fuel_type, engine, transmission, drivetrain, dimensions, pricing and more).
    - `colors` object[] — Available color options based on the vehicle's year, make and model.
      - `category` string
      - `name` string
    - `equipment` object — Equipment details based on the vehicle's year, make and model.
    - `warranties` object[] — Standard vehicle warranties by type, miles and months.
      - `type` string
      - `miles` string
      - `months` string
    - `deepdata` object — More information on the vehicle from the deep data search (present when `deepdata=1`).

## Other responses

- `400` — Missing plate, state, or API key.
- `401` — Missing API key, unknown/disabled API key, or inactive account.
- `404` — No data found for this plate/state combination.
- `429` — API usage limit exceeded for the current billing period.
- `500` — Internal server error.

---

[API](https://skmtc.net/carsxe/apis/carsxe-api.md) · [All operations](https://skmtc.net/carsxe/apis/carsxe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carsxe/carsxe-api/revisions/0343df02d7c4/schema)