Get Vehicle Recalls in Bulk
Look up many VINs in one call. The answer holds one item per VIN, in the order sent: exactly what GET /recalls/{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 /recalls/{vin} call, once per VIN per day; the bulk call itself is not counted.
Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY
In: header
Query Parameters
As on GET /recalls/{vin}, for every VIN.
"true""true" | "false"The 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/recalls/bulk?international=true" \ -H "Content-Type: application/json" \ -d '{ "vins": [ "1FMUK7DHXSGA27345", "5YJ3E1EA7KF317000" ] }'{
"bulk": {
"id": "6f1c0d52-3a4e-4a8e-9a43-0c4b0d1f2e3a",
"endpoint": "recalls",
"requested": 2,
"answered": 1,
"failed": 1,
"byStatus": {
"200": 1,
"400": 1
},
"retry": [],
"ms": 812
},
"results": [
{
"vin": "1FMUK7DHXSGA27345",
"statusCode": 200,
"data": [],
"totalRecalls": 0,
"internationalRecalls": [],
"internationalRecallCount": 0
},
{
"vin": "1FMUK7DHXSGA2734",
"statusCode": 400,
"error": {
"status": 400,
"error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
"code": "INVALID_VIN_FORMAT",
"path": "/recalls/1FMUK7DHXSGA2734",
"requestId": "a1b2c3d4e5f6g7h8"
}
}
]
}{
"error": {
"status": 400,
"error": "Send {\"vins\": [\"VIN1\", \"VIN2\", ...]}.",
"code": "BULK_BODY_INVALID",
"path": "/openrecalls/bulk",
"requestId": "a1b2c3d4e5f6g7h8"
}
}