Get Example VINs of New Vehicles

Up to 10 VINs of real vehicles, sampled from new vehicles' listings, to use with any VIN-based API. Takes the Vehicle Listings filters (vehicle.year, vehicle.make, vehicle.model, vehicle.trim and the rest); each call starts at a random place among the matching listings. A configuration no listing has answers an empty data.

GET
/example/new
AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Query Parameters

vehicle.year?integer

Model year, e.g. 2020

vehicle.make?string

Make, e.g. Ford

vehicle.model?string

Model, e.g. Escape

vehicle.trim?string

Trim, e.g. SE

limit?integer

Number of VINs, at most 10

Default10
Rangevalue <= 10

Response Body

curl -X GET "https://api.auto.dev/example/new?vehicle.year=0&vehicle.make=string&vehicle.model=string&vehicle.trim=string&limit=10"

{
  "data": [
    "https://data.vin/2T16CRAV0TC08F856",
    "https://data.vin/2T36CRAV0TC022999",
    "https://data.vin/2T36CRAV0TC054464"
  ]
}

{
  "error": {
    "status": 400,
    "error": "Invalid parameter provided: notacolumn. This parameter does not exist in this endpoint.",
    "code": "INVALID_PARAMETER",
    "path": "/example",
    "requestId": "a5986d089dad8c26"
  }
}