Get Vehicle Specifications in Bulk
Look up many VINs in one call. The answer holds one item per VIN, in the order sent: exactly what GET /specs/{vin} answers for that VIN, plus vin and statusCode. The call itself is 200 whenever it ran; a VIN that could not be answered is an item with its own error status, and is listed in bulk.retry when sending it again may help. There is no limit on how many VINs. A large list takes longer, about as fast as the Growth plan's requests per second allow, and the connection stays open until every VIN is answered. Each VIN answered with a 2xx counts as one GET /specs/{vin} call, once per VIN per day; the bulk call itself is not counted. A 207 (partial specifications) is not counted, as on GET /specs/{vin}.
Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY
In: header
Query Parameters
Whether to allow a best-guess answer for a VIN that matches several styles. By default (false) the answer does not guess: style is null, trim is null unless our sources settle it (on /specs, a 207 whose specs holds only the fields every style shares), and trims and styles list the possibilities. true allows a single best-guess pick. Also accepted as the X-Ambiguity header.
falseThe VINs to look up: a list, or one string with the VINs separated by commas, spaces or new lines. Each VIN is answered once, in the order sent. There is no limit on how many.
Response Body
curl -X POST "https://api.auto.dev/specs/bulk?ambiguity=false" \ -H "Content-Type: application/json" \ -d '{ "vins": [ "1FMUK7DHXSGA27345", "5YJ3E1EA7KF317000" ] }'{
"bulk": {
"id": "6f1c0d52-3a4e-4a8e-9a43-0c4b0d1f2e3a",
"endpoint": "specs",
"requested": 2,
"answered": 1,
"failed": 1,
"byStatus": {
"200": 1,
"400": 1
},
"retry": [],
"ms": 1412
},
"results": [
{
"vin": "1FMUK7DHXSGA27345",
"statusCode": 200,
"vehicle": {
"vin": "1FMUK7DHXSGA27345",
"year": 2025,
"make": "Ford",
"model": "Explorer"
},
"specs": {
"name": "2025 Ford Explorer Active 4dr SUV (2.3L 4cyl Turbo 10A)"
}
},
{
"vin": "1FMUK7DHXSGA2734",
"statusCode": 400,
"error": {
"status": 400,
"error": "Invalid VIN format: 1FMUK7DHXSGA2734",
"code": "INVALID_VIN_FORMAT",
"path": "/specs/1FMUK7DHXSGA2734",
"requestId": "a1b2c3d4e5f6g7h8"
}
}
]
}{
"error": {
"status": 400,
"error": "Send {\"vins\": [\"VIN1\", \"VIN2\", ...]}.",
"code": "BULK_BODY_INVALID",
"path": "/openrecalls/bulk",
"requestId": "a1b2c3d4e5f6g7h8"
}
}