Recherche

Recherchez un véhicule réel par numéro d'immatriculation

GET/plate/{plate}

Transformez un numéro d'immatriculation en données de véhicule et en images studio de cette voiture exacte, y compris sa couleur de peinture réelle lorsque nous avons une correspondance.

Add-on — doit être activé pour votre clé. Vérifiez features.plate dans /api/me. Sans cela, l'endpoint renvoie 403.

Ce que vous recevez en retour.

Le véhicule derrière la plaque : marque, modèle, année, carrosserie, couleur, moteur, transmission et son VIN.
Un bloc vehicle avec la voiture du catalogue correspondante et une URL d'image signée par vue que votre plan autorise.

La couleur est appliquée automatiquement. Si la voiture est enregistrée en blanc, les images reviennent en blanc. Les couleurs que nous ne proposons pas (par exemple, argent, beige) reviennent à la finition standard — vehicle.color indique toujours ce qui a été utilisé.

La couverture varie selon les pays. Le Royaume-Uni, la plupart de l'Europe, les États-Unis et un certain nombre d'autres marchés sont pris en charge; certains pays restreignent les recherches d'immatriculation par la loi. Les espaces et les tirets sur la plaque sont ignorés.

Paramètres de chemin

Nom	Type	Description
`plate` obligatoire	chaîne	Numéro d'immatriculation. Les espaces et les tirets sont ignorés

Paramètres de requête.

Nom	Type	Description
`country`	chaîne	Pays d'immatriculation. Par défaut, le Royaume-Uni.

Demande

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

200 · Véhicule derrière la plaque plus la voiture du catalogue correspondante et ses images.

{
  "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 · Le numéro d'immatriculation n'est pas utilisable. Rien n'est facturé.

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

403 · L'add-on plaque n'est pas activé pour votre clé.

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

404 · Aucun véhicule trouvé pour ce numéro d'immatriculation.

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

502 · Recherche temporairement indisponible, réessayez bientôt. Rien n'est facturé.

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