Vehicle Photos API

Retrieve a collection of high-quality retail images for a specific vehicle based on its VIN. Get comprehensive photo collections including exterior, interior, and detail shots from dealer listings and auction sources.

Endpoint

GET https://api.auto.dev/photos/{vin}

Parameters

Prop	Type	Default
`vin`	`string`	-

Example Request

curl -X GET "https://api.auto.dev/photos/1FTEW1C52PFA86825" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Structure

Prop	Type	Default
`data.retail?`	`string[]`	-

Example Response

Vehicle with Photos

{
  "data": {
    "retail": [
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-1.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-2.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-3.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-4.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-5.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-6.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-7.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-8.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-9.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-10.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-11.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-12.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-13.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-14.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-15.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-16.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-17.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-18.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-19.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-20.jpg",
      "https://api.auto.dev/photos/retail/1FTEW1C52PFA86825-21.jpg"
    ]
  }
}

Vehicle without Photos

When no photos are available for a VIN, the API returns empty arrays instead of an error:

{
  "data": {
    "retail": []
  }
}

Photo Collection Details

Photo Sources

Retail Photos: Professional dealer listings and inventory photos

Format: JPEG images hosted on Auto.dev CDN
URL Pattern: https://api.auto.dev/photos/{source}/{vin}-{number}.jpg
Availability: Retail photos are more common; wholesale may be empty

Typical Photo Content

Collections include exterior shots, interior views, engine bay, detail shots, and any damage documentation. Photos are ordered by importance with primary exterior views first, followed by additional angles, interior, and detail shots.

Use Cases

Marketplace Listings: Display comprehensive vehicle galleries with retail photos
Inventory Management: Visual catalog of dealer stock with multiple photo sources
Insurance & Appraisal: Document vehicle condition for claims and assessments

Image Specifications

Prop	Type	Default
`format?`	`string`	`JPEG`
`quality?`	`string`	`High-resolution retail/auction quality`
`dimensions?`	`string`	`Varies (typically 800x600 to 1200x800)`
`cdn_hosting?`	`string`	`api.auto.dev`
`url_pattern?`	`string`	`https://api.auto.dev/photos/{source}/{vin}-{number}.jpg`

Error Responses

Invalid VIN

{
  "status": 404,
  "error": "This vehicle does not have any photos available. Please try a different VIN.",
  "code": "RESOURCE_NOT_FOUND",
  "path": "/photos/123Invalid",
  "requestId": "966d92f81daff05e"
}

Plan Availability

Starter: ✅ Available
Growth: ✅ Available
Scale: ✅ Available

See pricing for plan details and signup.

Vehicle Photos API

On this page