To retrieve a vehicle images request:

https://images.vinaudit.com/v3/images

With GET parameters:
When searching by VIN:

Successful Response

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.

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

Custom Resolution Example

https://images.vinaudit.com/v3/images?id=2018_ford_expedition_xlt&color=blue&size=1024x1024&key=YOUR_API_KEY_HERE&format=json