---
title: "License Plate Decoder (v2)"
method: GET
path: "/v2/platedecoder"
tags: ["Plate Decoder"]
---

# License Plate Decoder (v2)

`GET /v2/platedecoder`

Decode a license plate into vehicle data across 60+ supported
countries. `country` is an ISO 3166-1 alpha-2 code (optional for `US`).
`state` is required for `US`, `AU` and `CA`. For Pakistan (`PK`) a
`district` is also required for the Khyber-Pakhtunkhwa province.

For Spain (`ES`), set `require_vin=true` to always include a VIN.
Additional charges apply: when `require_vin=true`, the request is
billed 2x and usage counts 2x.

## Query parameters

- `plate` string, required
- `country` string
- `state` string
- `district` string
- `require_vin` boolean

## Response `200`

Plate decoded.

- object
  - `success` boolean
  - `input` object
  - `description` string
  - `make` string
  - `model` string
  - `trim` string
  - `vin` string
  - `year` string

## Other responses

- `400` — Missing plate, or `require_vin` used with a country other than ES.
- `401` — Missing API key, unknown/disabled API key, or inactive account.
- `404` — Invalid state/country/district, or no data found for this plate.
- `429` — API usage limit exceeded for the current billing period.

---

[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)