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, or Spec ID.
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:
When searching by VIN:
When searching by ID:
Successful Response
Set format=html
Returns a directly embeddable HTML-rendered image
Set format=json to return the following structured fields:
Returns a JSON object indicating failure:
https://images.vinaudit.com/v3/imagesWith 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, gray (or grey), silver, blue, red, green, brown, beige, gold, orange, purple, yellow |
| background | Use the optional background parameter to set the scene | no | gallery, white |
| size | Use the optional size parameter to set the size of the image | no |
Predefined Tiers:
|
| Parameter | Description | Required | Examples |
|---|---|---|---|
| id | Unique identifier associated with each of the following attribute combinations: year_make_model_trim year_make_model_trim_style |
yes | 2024_maserati_mc20_cielo |
| 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, gray (or grey), silver, blue, red, green, brown, beige, gold, orange, purple, yellow |
| background | Use the optional background parameter to set the scene | no | gallery, white |
| size | Use the optional size parameter to set the size of the image | no |
Predefined Tiers:
|
Set format=html
Returns a directly embeddable HTML-rendered image
Set format=json to return the following structured fields:
{
"id": "2024_maserati_mc20_cielo",
"images": [
{
"content_type": "image/png",
"data": "iVBORw0KGgoAAAANSUhMuAAEAAE..."
}
],
"success": true,
"ymmt": {
"year": "2024",
"make": "Maserati",
"model": "MC20",
"trim": "Cielo"
}
}
Set format=xml to return the following structured fields:
<result>
<id>2024_maserati_mc20_cielo</id>
<images>
<record>
<content_type>image/png</content_type>
<data>iVBORw0KGgoAAAANSUhMuAAEAAE...</data>
</record>
</images>
<success>1</success>
<ymmt>
<year>2024</year>
<make>Maserati</make>
<model>MC20</model>
<trim>Cielo</trim>
</ymmt>
</result>
Error Response
Returns a JSON object indicating failure:
{
"success": false,
"error": "Invalid input or unsupported vehicle configuration"
}
Notes
- The default response is JSON.
- For json/xml, the API now returns binary/base64 image data instead of URLs (removes API key exposure).
- HTML remains supported for viewing/debugging purposes.
- Invalid parameters (pose, format, background, color, size) return descriptive error messages.
https://images.vinaudit.com/v3/images?vin=5J8TC1H38KL003076&pose=front_right&color=white&background=gallery&key=YOUR_API_KEY_HERE&format=htmlExample 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=htmlCustom Resolution Example
https://images.vinaudit.com/v3/images?id=2018_ford_expedition_xlt&color=blue&size=1024x1024&key=YOUR_API_KEY_HERE&format=json
System Constraints and Behavior
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.
Spec ID Priority
If multiple identifiers are passed, priority is vin > id.
If multiple identifiers are passed, priority is vin > id.
Fallback on Trims
If the requested trim does not exist, API returns images for an available trim of the same model.
If the requested trim does not exist, API returns images for an available trim of the same model.
Background
Defaults to white unless specified.
Defaults to white unless specified.
Resolution Support
Validated from small (640×480) up to full (6000×4000), plus custom sizes.
Validated from small (640×480) up to full (6000×4000), plus custom sizes.
Concurrency
Multiple workers confirmed to handle concurrent requests.
Multiple workers confirmed to handle concurrent requests.
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
- Research & White Papers
- Auto Market Analytics Articles
- VIN Decoder & Lookup
