Búsqueda

Buscar un vehículo real por número de registro

OBTENER/plate/{plate}

Convierte un número de registro en datos del vehículo y imágenes de estudio de ese coche exacto, incluyendo su color de pintura real cuando tengamos una coincidencia.

Add-on — debe estar habilitado para tu clave. Revisa features.plate en /api/me. Sin él, el punto final devuelve 403.

Lo que obtienes

El vehículo detrás de la placa: marca, modelo, año, carrocería, color, motor, transmisión y su VIN.
Un bloque de vehicle con el coche coincidente del catálogo y una URL de imagen firmada por vista que permita su plan.

El color se aplica automáticamente. Si el coche está registrado como blanco, las imágenes vuelven en blanco. Los colores que no llevamos (por ejemplo, plata, beige) se caen en el acabado estándar — vehicle.color siempre indica lo que se utilizó realmente.

La cobertura varía según el país. El Reino Unido, la mayor parte de Europa, EE. UU. y un número de otros mercados están soportados; algunos países restringen las búsquedas de registro por ley. Los espacios y los guiones en la matrícula se ignoran.

Parámetros de ruta

Nombre	Tipo	Descripción
`plate` requerido	cadena	Número de registro. Los espacios y los guiones se ignoran.

Parámetros de consulta

Nombre	Tipo	Descripción
`country`	cadena	País de registro. Por defecto, el Reino Unido.

Solicitud

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

200 · Vehículo detrás de la placa más el auto del catálogo coincidente y sus imágenes.

{
  "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 · El número de registro no es utilizable. No se cobra nada.

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

403 · El complemento de placa no está habilitado para su clave.

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

404 · No se encontró ningún vehículo para este número de registro.

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

502 · La búsqueda no está disponible temporalmente — inténtelo de nuevo en breve. No se cobra nada.

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