---
title: "Supported Countries"
description: "Reference for the country parameter accepted by CarsXE API endpoints — valid values, regional requirements, and per-endpoint coverage."
canonical_url: "https://docs.carsxe.com/docs/guides/supported-countries"
markdown_url: "https://docs.carsxe.com/docs/guides/supported-countries.md"
last_updated: "1980-01-01"
---

# Supported Countries
URL: /docs/guides/supported-countries
LLM index: /llms.txt
Description: Reference for the country parameter accepted by CarsXE API endpoints — valid values, regional requirements, and per-endpoint coverage.

Several CarsXE endpoints accept an optional `country` parameter as an ISO 3166-1 alpha-2 code (e.g. `country=DE`). It defaults to `US` when omitted. This page is the authoritative reference for valid values and per-endpoint behavior.

## Endpoint coverage

| Endpoint | Accepts `country` | Coverage |
|---|---|---|
| `GET /v2/platedecoder` | Yes | 57 countries — see table below |
| `GET /v2/marketvalue` | Yes | Primarily US |

## Regional requirements

<Note>
  Some endpoints require additional location context depending on the country:

  - **State or province is required** for US, Australian, Canadian, and Pakistani lookups — use the standard two-letter code (e.g. `CA`, `NSW`, `ON`).
  - **Pakistan** additionally supports a `district` parameter for more precise lookups.

  Coverage and field availability vary by country. Some regions return a full data set; others return only identity fields like make, model, and year.
</Note>

## All supported countries

The table below reflects the full set of countries supported by `/v2/platedecoder`. Other endpoints may support a subset.

| Code | Country | Code | Country |
|---|---|---|---|
| `AE` | United Arab Emirates | `AL` | Albania |
| `AR` | Argentina | `AU` | Australia |
| `BE` | Belgium | `BO` | Bolivia |
| `BR` | Brazil | `CA` | Canada |
| `CH` | Switzerland | `CL` | Chile |
| `CN` | China | `CO` | Colombia |
| `CR` | Costa Rica | `CY` | Cyprus |
| `CZ` | Czech Republic | `DE` | Germany |
| `DK` | Denmark | `EC` | Ecuador |
| `EE` | Estonia | `ES` | Spain |
| `FI` | Finland | `GB` | United Kingdom |
| `GR` | Greece | `HR` | Croatia |
| `HU` | Hungary | `IE` | Ireland |
| `IL` | Israel | `IM` | Isle of Man |
| `IN` | India | `IS` | Iceland |
| `IT` | Italy | `KZ` | Kazakhstan |
| `LK` | Sri Lanka | `LT` | Lithuania |
| `LV` | Latvia | `MT` | Malta |
| `MX` | Mexico | `MY` | Malaysia |
| `NG` | Nigeria | `NL` | Netherlands |
| `NO` | Norway | `NZ` | New Zealand |
| `OM` | Oman | `PE` | Peru |
| `PK` | Pakistan | `PL` | Poland |
| `PT` | Portugal | `RO` | Romania |
| `RU` | Russia | `SE` | Sweden |
| `SG` | Singapore | `SI` | Slovenia |
| `SK` | Slovakia | `TN` | Tunisia |
| `TW` | Taiwan | `UA` | Ukraine |
| `US` | United States | `ZA` | South Africa |

## Spain — guaranteed VIN

Spain (`ES`) has a special `require_vin=1` parameter available on `/v2/platedecoder`. By default, Spanish plate lookups use a standard provider that does not guarantee a VIN. Pass `require_vin=1` to route through a higher-cost provider that always includes a VIN in the response.

```bash
curl -G https://api.carsxe.com/v2/platedecoder \
  -d key=YOUR_API_KEY \
  -d plate=1234ABC \
  -d state=MA \
  -d country=ES \
  -d require_vin=1
```

This costs **2× a standard lookup** and only applies to `country=ES` on the plate decoder endpoint. See the [Plate Decoder](/docs/products/plate-decoder) docs for full parameter details.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).