US
CA
Vehicle Images API Overview
The Vehicle Images API provides programmatic access to high-quality, OEM-style rendered vehicle images. It supports use cases such as embedding visuals in reports, marketing content, or consumer-facing applications based on identifiers like VIN, Spec ID, or Year/Make/Model/Trim (YMMT).
The API supports customizable rendering through optional parameters like pose, color, background, and format, and implements a watermarking system to protect usage across demo and production environments.
The API supports customizable rendering through optional parameters like pose, color, background, and format, and implements a watermarking system to protect usage across demo and production environments.
Documentation
To retrieve a vehicle images request:
https://images.vinaudit.com/v3/images
With GET parameters:
When searching by VIN:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| vin | The vehicle identification number | yes | 1NXBR32E85Z505904 |
| key | Your VinAudit API key | yes | YOUR_API_KEY_HERE |
| format | The output format: html, json, or xml | no | html, json, xml |
| pose | Use the optional pose parameter to control the image/view angle returned. | no | front_left, front_right, front, back_left, back_right, back, right, left |
| color | Use the optional color parameter to request a specific vehicle color. | no | white, black, red, gray, yellow, green |
| background | Use the optional background parameter to set the scene | no | gallery, white |
When searching by YMMT ID:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| id | The YMMT ID selected from the VinAudit Specifications API | yes | 2005_toyota_corolla_ce |
| key | Your VinAudit API key | yes | YOUR_API_KEY_HERE |
| format | The output format: html, json, or xml | no | html, json, xml |
| pose | Use the optional pose parameter to control the image/view angle returned. | no | front_left, front_right, front, back_left, back_right, back, right, left |
| color | Use the optional color parameter to request a specific vehicle color. | no | white, black, red, gray, yellow, green |
| background | Use the optional background parameter to set the scene | no | gallery, white |
When searching by YMMT:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| year | The selected vehicle year | yes | 2019 |
| make | The selected vehicle make | yes | Mini |
| model | The selected vehicle model | yes | Countryman |
| trim | The selected vehicle trim | no | S |
| key | Your VinAudit API key | yes | YOUR_API_KEY_HERE |
| format | The output format: html, json, or xml | no | html, json, xml |
| pose | Use the optional pose parameter to control the image/view angle returned. | no | front_left, front_right, front, back_left, back_right, back, right, left |
| color | Use the optional color parameter to request a specific vehicle color. | no | white, black, red, gray, yellow, green |
| background | Use the optional background parameter to set the scene | no | gallery, white |
Successful Response
Set format=html
Returns a directly embeddable HTML-rendered image
Set format=json or format=xml to return the following structured fields:
{
"success": true,
"image_url": "https://cdn.vinaudit.com/...",
"id": "2024_maserati_mc20_cielo",
"ymmt": {
"year": 2024,
"make": "maserati",
"model": "mc20",
"trim": "cielo"
}
}
Error Response
Returns a JSON object indicating failure:
{
"success": false,
"error": "Invalid input or unsupported vehicle configuration"
}
Example Request by VIN
https://images.vinaudit.com/v3/images?vin=5J8TC1H38KL003076&pose=front_right&color=white&background=gallery&key=YOUR_API_KEY_HERE&format=html
Example Request by YMMT ID
https://images.vinaudit.com/v3/images?id=2024_maserati_mc20_cielo&pose=front_right&color=white&background=gallery&key=YOUR_API_KEY_HERE&format=html
Example Request by Year, Make, Model, Trim
https://images.vinaudit.com/v3/images?year=2019&make=mini&model=countryman&trim=s&pose=front_right&color=white&background=gallery&key=YOUR_API_KEY_HERE&format=html
Example Request by Year, Make, Model
https://images.vinaudit.com/v3/images?year=2019&make=mini&model=countryman&pose=front_right&color=white&background=gallery&key=YOUR_API_KEY_HERE&format=html
System Constraints and Behavior
YMMT Validity
Year/Make/Model must exist in the in-market list. If trim is specified, it must match a valid trim for that YMM.
Year/Make/Model must exist in the in-market list. If trim is specified, it must match a valid trim for that YMM.
https://images.vinaudit.com/v3/selections?key=YOUR_API_KEY_HERE&list=year+make+model+trim&format=csv&country=usa&collection=in-market
VIN Resolution
VINs must resolve to a valid id (spec ID) in the system.
VINs must resolve to a valid id (spec ID) in the system.
Input Priority
Priority of resolution if multiple inputs are present: vin > id > ymmt
Priority of resolution if multiple inputs are present: vin > id > ymmt
Batch Limitation
Only single-image requests are supported per API call.
Only single-image requests are supported per API call.
Ping Endpoint (for health check)
https://images.vinaudit.com/v3/images/ping
The most comprehensive Automotive Data & Analytics
- Automotive Market Trends & Insights
- White Papers & Researches
- Auto Market Analytics Articles
- VIN Decoder & Lookup
