Búsqueda

Busque un vehículo real por número de matrícula (Beta)

OBTENER/plate/{plate}

> Beta. Este endpoint está en vivo y es utilizable, pero aún está evolucionando: los campos de respuesta pueden cambiar, y la cobertura del país y la coincidencia del catálogo se están expandiendo. Se agradece la retroalimentación. Por favor, no construya nada crítico para la misión en la forma exacta de la respuesta aún.

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

Add-on: debe estar habilitado para su clave. Revisar features.plate en /api/me; sin él, el endpoint 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 tenemos (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 · Consulta temporalmente no disponible, vuelva a intentarlo en breve. No se cobra nada.

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