CarsXE

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

EndpointAccepts countryCoverage
GET /v2/platedecoderYes57 countries — see table below
GET /v2/marketvalueYesPrimarily US

Regional requirements

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.

All supported countries

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

CodeCountryCodeCountry
AEUnited Arab EmiratesALAlbania
ARArgentinaAUAustralia
BEBelgiumBOBolivia
BRBrazilCACanada
CHSwitzerlandCLChile
CNChinaCOColombia
CRCosta RicaCYCyprus
CZCzech RepublicDEGermany
DKDenmarkECEcuador
EEEstoniaESSpain
FIFinlandGBUnited Kingdom
GRGreeceHRCroatia
HUHungaryIEIreland
ILIsraelIMIsle of Man
INIndiaISIceland
ITItalyKZKazakhstan
LKSri LankaLTLithuania
LVLatviaMTMalta
MXMexicoMYMalaysia
NGNigeriaNLNetherlands
NONorwayNZNew Zealand
OMOmanPEPeru
PKPakistanPLPoland
PTPortugalRORomania
RURussiaSESweden
SGSingaporeSISlovenia
SKSlovakiaTNTunisia
TWTaiwanUAUkraine
USUnited StatesZASouth 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.

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 for full parameter details.