A VIN or a plate goes in; the vehicle, the matching car and its images come out. The responses below are examples in the format of the API.
It arrives in a stock feed, on a registration document or in a spreadsheet from the leasing company. Seventeen characters become the vehicle and its images.
GET /api/vin/W1N0G8EB0RF000000
{
"make": "Mercedes-Benz",
"model": "GLC",
"year": 2026,
"body": "SUV",
"engine": { "fuel": "electric", … },
"vehicle": {
"matched": true,
"confidence": "high",
"model": "GLC EQ",
"images": { "front_left": "https://cdn…", … }
}
}
Somebody typed it into a trade-in form, or read it off the car in front of them. The plate becomes the vehicle, its VIN, and images in the colour it is registered in.
GET /api/plate/BKS2024?country=DE
{
"make": "Kia",
"model": "Sportage",
"year": 2024,
"colour": "White",
"vin": "U5YPV81CBRL000000",
"vehicle": {
"matched": true,
"confidence": "high",
"color": "white",
"images": { "front_left": "https://cdn…", … }
}
}
One request, three things in the answer. No second call, no mapping table of your own.
Make, model, year, trim, body, engine, gearbox and drivetrain. A plate adds the VIN behind it and the colour it is registered in.
The closest car in our catalogue, from the generation that covers the vehicle's year, and a confidence that says how close it is.
One signed image URL per view your plan allows. From a plate, the car comes back in its registered colour wherever we carry it.
Every answer says how well the catalogue car fits, because a near miss is a normal outcome in this business. You decide what to do with it.
highThe catalogue car is the vehicle. Publish it.mediumThe right model, with something below it uncertain, like a variant or a facelift year. Fine for a listing thumbnail, worth a glance before a hero image.lowThe nearest car we have. Treat it as a suggestion, and consider showing nothing instead.The UK, most of Europe, the USA and a number of further markets; some countries restrict registration lookups by law. Pass country when you know it. Without it the lookup assumes the UK.
You get matched: false and no images, together with the decoded data. A wrong car on a listing costs more than an empty slot.
From a plate, yes, wherever we carry that colour for the car. Colours we do not carry fall back to the standard finish, and vehicle.color always says which one was used.
No, they are add-ons. Your key has them or it does not, and GET /api/me tells you which. Ask us and we switch them on. Both endpoints are in beta and still gaining coverage.
Yes. The matched car is an ordinary catalogue entry, so you can ask for it in any OEM or custom colour, with your logo on the plate and in every angle.
Send us a handful of VINs or plates from your stock. We run them through the lookup and send back what comes out, vehicle data and images included.
