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

# License Plate Decoder (v1)

`GET /platedecoder`

Decode a license plate into vehicle data. Internally proxies to the v2
plate decoder. The `state` parameter accepts a two-letter US state
code, Australian state, or one of the legacy country codes `BR`, `UK`,
`IR`, `IT`, `ES`, `IND`, `MX`, `NZ`.

## Query parameters

- `plate` string, required
- `state` string, required
- `country` string
- `format` 'json' | 'xml'

## Response `200`

Plate decoded.

- object
  - `success` boolean
  - `input` object
  - `vin` string

## Other responses

- `400` — Missing plate or state.
- `401` — Missing API key, unknown/disabled API key, or inactive account.
- `404` — No data found for this plate (passed through from the v2 decoder).
- `429` — API usage limit exceeded for the current billing period.
- `502` — Upstream plate decoder request failed.
- `504` — Upstream plate decoder request timed out.

---

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