Consulta

Consulte um veículo real pelo número de registro

GET/plate/{plate}

Transforme um número de registro em dados de veículo e imagens de estúdio do carro exato — incluindo sua cor real quando temos uma correspondência.

Add-on — deve estar habilitado para sua chave. Verifique features.plate em /api/me. Sem ele, o endpoint retorna 403.

O que você recebe de volta

O veículo atrás da placa: marca, modelo, ano, carroceria, cor, motor, transmissão e seu VIN
Um bloco vehicle com o carro do catálogo correspondente e uma URL de imagem assinada por vista que seu plano permite.

A cor é aplicada automaticamente. Se o carro estiver registrado como branco, as imagens retornam em branco. Cores que não carregamos (por exemplo, prata, bege) caem para o acabamento padrão — vehicle.color sempre indica o que foi realmente usado.

A cobertura varia por país. O Reino Unido, a maioria da Europa, os EUA e um número de outros mercados são suportados; alguns países restringem consultas de registro por lei. Espaços e hífens na placa são ignorados.

Parâmetros de caminho

Nome	Tipo	Descrição
`plate` obrigatório	string	Número de registro. Espaços e hífens são ignorados

Parâmetros de consulta

Nome	Tipo	Descrição
`country`	string	País de registro. Por padrão, o Reino Unido.

Solicitar

curl "https://api.vehicleimagery.com/plate/plate?country=uk" \
  -H "x-api-key: YOUR_API_KEY"

200 · Veículo atrás da placa mais o carro do catálogo correspondente e suas imagens.

{
  "plate": "AB12CDE",
  "make": "Vauxhall",
  "model": "Astra SRI Turbo",
  "year": 2017,
  "body": "Hatchback",
  "colour": "White",
  "vin": "W0LBF6EC2HG138041",
  "engine": {
    "displacement_ccm": 1399,
    "fuel": "Petrol",
    "code": "B 14 XFT"
  },
  "transmission": "Manual",
  "doors": 5,
  "seats": 5,
  "vehicle": {
    "matched": true,
    "confidence": "medium",
    "id": 402118773,
    "brand": "Vauxhall",
    "model": "Astra_Mk7",
    "year": 2015,
    "variant": "Basis",
    "trim": "base",
    "color": "white",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · O número de registro não é utilizável. Nada é cobrado.

{
  "error": "Invalid registration number."
}

403 · O add-on de placa não está ativado para sua chave.

{
  "error": "The plate add-on is not enabled for your API key."
}

404 · Nenhum veículo encontrado para este número de registro.

{
  "error": "No data found for this registration number.",
  "plate": "AB12CDE"
}

502 · Consulta temporariamente indisponível, tente novamente em breve. Nada é cobrado.

{
  "error": "Plate lookup temporarily unavailable."
}