Get Open Recalls in Bulk

Look up many VINs in one call. The answer holds one item per VIN, in the order sent: exactly what GET /openrecalls/{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 Scale 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 /openrecalls/{vin} call, once per VIN per day; the bulk call itself is not counted.

POST
/openrecalls/bulk
AuthorizationBearer <token>

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

In: header

Query Parameters

recalls?string

As on GET /openrecalls/{vin}, for every VIN.

Value in"true" | "false"
vinsarray<string> | string

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/openrecalls/bulk?recalls=true" \  -H "Content-Type: application/json" \  -d '{    "vins": [      "1FMUK7DHXSGA27345",      "5YJ3E1EA7KF317000"    ]  }'

{
  "bulk": {
    "id": "6f1c0d52-3a4e-4a8e-9a43-0c4b0d1f2e3a",
    "endpoint": "openrecalls",
    "requested": 2,
    "answered": 1,
    "failed": 1,
    "byStatus": {
      "200": 1,
      "503": 1
    },
    "retry": [
      "5YJ3E1EA7KF317000"
    ],
    "ms": 21480
  },
  "results": [
    {
      "vin": "1FMUK7DHXSGA27345",
      "statusCode": 200,
      "vehicle": {
        "year": 2025,
        "make": "Ford",
        "model": "Explorer",
        "vin": "1FMUK7DHXSGA27345"
      },
      "retrievedAt": "2026-11-18T19:00:00.000Z",
      "status": "No Open Recalls",
      "openRecalls": 0,
      "totalRecalls": 3,
      "data": []
    },
    {
      "vin": "5YJ3E1EA7KF317000",
      "statusCode": 503,
      "error": {
        "status": 503,
        "error": "Recall information is temporarily unavailable. Please retry shortly.",
        "code": "RECALLS_UNAVAILABLE",
        "path": "/openrecalls/5YJ3E1EA7KF317000",
        "requestId": "a1b2c3d4e5f6g7h8"
      },
      "retryAfter": 30
    }
  ]
}

{
  "error": {
    "status": 400,
    "error": "Send {\"vins\": [\"VIN1\", \"VIN2\", ...]}.",
    "code": "BULK_BODY_INVALID",
    "path": "/openrecalls/bulk",
    "requestId": "a1b2c3d4e5f6g7h8"
  }
}