---
title: "Vehicle Images API"
method: GET
path: "/v3/images"
tags: ["Images"]
---

# Vehicle Images API

`GET /v3/images`

## Request

- Base URL: `https://images.vinaudit.com`
- URL: `https://images.vinaudit.com/v3/images`
- Auth: API key in query parameter `key`
- TypeScript: <https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/docs/v3/images/get.ts> (a function with typed inputs; its response is checked against the schema)

OEM-style rendered vehicle images by VIN or spec ID, with pose, color, background, size and format options. Pass either `vin` or `id`. JSON/XML responses return base64 image data.

## Query parameters

- `vin` string
- `id` string
- `format` 'json' | 'xml' | 'html'
- `pose` 'front_left' | 'front_right' | 'front' | 'back_left' | 'back_right' | 'back' | 'right' | 'left'
- `color` 'white' | 'black' | 'gray' | 'grey' | 'silver' | 'blue' | 'red' | 'green' | 'brown' | 'beige' | 'gold' | 'orange' | 'purple' | 'yellow'
- `background` 'white' | 'gallery'
- `size` string
- `granularity` 'trim' | 'model'
- `crop` boolean

## Response `200`

Rendered vehicle image(s)

- object
  - `id` string
  - `success` boolean
  - `error` string
  - `images` object[]
    - `content_type` string
    - `data` string, byte: Base64 image data
  - `ymmt` object
    - `year` string
    - `make` string
    - `model` string
    - `trim` string

---

[API](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis.md) - [All operations](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/revisions/1f1500e74b46?raw)