---
title: "License Plate Lookup"
method: GET
path: "/api/license-plate"
tags: ["License Plate"]
---

# License Plate Lookup

`GET /api/license-plate`

Returns information about the vehicle and the Vehicle Identification Number (VIN) associated to the license
plate. Data requirements around the region parameter differ based on the country_code you are requesting data
for. Refer to https://carapi.app/docs/ for additional documentation. Each country makes available different data
so depending on the country requested some values may be returned as null.

For testing, any lookup containing the string "#TEST" will return test data. Example:

- United States: `/api/license-plate?country_code=US&region=NY&lookup=830UNL#TEST`
- Canada: `/api/license-plate?country_code=CA&region=BC&lookup=#TEST`
- United Kingdom: `/api/license-plate?country_code=UK&lookup=#TEST-LD59YMR`

The following countries are currently supported: US, CA, AU, UK, FR, IE, NZ, MX, CZ and PT

## Query parameters

- `country_code` string, required
- `lookup` string, required
- `region` string

## Response `200`

- object
  - `year` integer, nullable — Returned for all countries except for Germany
  - `make` string
  - `model` string
  - `body` string, nullable
  - `vin` string, nullable — Returned for all countries except for Ireland
  - `engine_description` string, nullable
  - `assembled_in` string, nullable

## Other responses

- `400` — BadRequestException
- `404` — NotFoundException
- `405` — MethodNotAllowedException
- `429` — TooManyRequestsException - Max Per Minute: 600
- `503` — ServiceUnavailableException

---

[API](https://skmtc.net/carapi/apis/car-api-documentation.md) · [All operations](https://skmtc.net/carapi/apis/car-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carapi/car-api-documentation/revisions/5331e15a22af/schema)
