Integration is simple when you leverage your exisitng EVOX Image Licence with this additional VRM lookup.
Key Features
VRM-based Lookup
Easily retrieve the closest matching images from the EVOX library from a registration mark
DVLA to OE colour mapping
Generic DVLA colour is mapped to all corresponding OE colours
3 Image Set
Links to 3 images for each mapped vehicle and colour combination
Easy Integration
The easiest way to get high quality images from a VRM
Multiple Formats
Choose from a range of sizes and backgrounds (inc transparent)
Consistent Quality
Images are consistent in angles, lighting and post-production
Sample Response
V1
Documentation
Introduction
This endpoint returns high quality vehicle images, in multiple angles and all manufacturer colours.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/evox/colourimagesetfromvrm?vehicle_registration_mark=AB21ABC&image_specification=D
Example Sandbox Request
https://sandbox.oneautoapi.com/evox/colourimagesetfromvrm?vehicle_registration_mark=AB21ABC&image_specification=D
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
image_specification
mandatory, string, e.g. D
The size and type of images to be returned (JPEG) - A (320X240), B (480X360), C (680X480), D* (680X480), E (1280X960), F (2400X1800), G (2400X1800) *transparent background
Sample Response
{
"success": true,
"result": [
{
"vehicle_desc": "Mini Cooper S",
"number_doors": 3,
"body_type_desc": "hatchback",
"oem_model_year": 2021,
"image_library_source": "EU",
"is_best_match": true,
"oem_colour_desc_list": [
"Alpine White",
"Black Sapphire Metallic",
"Sunset Orange Metallic",
"Arctic Grey",
"Tanzanite Blue Metallic"
],
"images": [
{
"oem_colour_desc": "Midnight Black Metallic",
"generic_colour_desc": "Black",
"side_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg",
"rear_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg",
"front_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg"
}
],
"end_user_licence_agreement_url": "https://www.evox.com/20181025/eula/EVOX_sublicensee_EULA.pdf"
}
],
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_desc
e.g. Mini Cooper S
The Vehicle description
number_doors
e.g. 3
Number of doors.
body_type_desc
e.g. hatchback
The body type description
oem_model_year
e.g. 2021
The OEM's model year
image_library_source
e.g. EU
The EVOX image library source
is_best_match
e.g. true
Boolean identifying the closest matching image
oem_colour_desc
e.g. Midnight Black Metallic
The OEM's colour description
generic_colour_desc
e.g. Black
The generic colour description
side_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg
The side image URL
rear_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg
The rear image URL
front_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg
The front image URL
end_user_licence_agreement_url
e.g. https://www.evox.com/20181025/eula/EVOX_sublicensee_EULA.pdf
Theend user licence agreement
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call
Status Codes
200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com