Get OEM Build Data in Bulk

Look up many VINs in one call. The answer holds one item per VIN, in the order sent: exactly what GET /build/{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 /build/{vin} call, once per VIN per day; the bulk call itself is not counted. As on GET /build/{vin}, only a VIN answered with its build (a 200) is counted: a 207 or a 404 is not.

POST
/build/bulk
AuthorizationBearer <token>

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

In: header

Query Parameters

includeStandard?boolean

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

Defaultfalse
array?string

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

ambiguity?boolean

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

Defaultfalse
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/build/bulk?includeStandard=false&array=string&ambiguity=false" \  -H "Content-Type: application/json" \  -d '{    "vins": [      "1FMUK7DHXSGA27345",      "5YJ3E1EA7KF317000"    ]  }'

{
  "bulk": {
    "id": "6f1c0d52-3a4e-4a8e-9a43-0c4b0d1f2e3a",
    "endpoint": "build",
    "requested": 2,
    "answered": 1,
    "failed": 1,
    "byStatus": {
      "200": 1,
      "400": 1
    },
    "retry": [],
    "ms": 1412
  },
  "results": [
    {
      "vin": "1FMUK7DHXSGA27345",
      "statusCode": 200,
      "build": {
        "vin": "1FMUK7DHXSGA27345",
        "year": 2025,
        "make": "Ford",
        "model": "Explorer",
        "trim": "Active"
      }
    },
    {
      "vin": "1FMUK7DHXSGA2734",
      "statusCode": 400,
      "error": {
        "status": 400,
        "error": "Invalid VIN format: 1FMUK7DHXSGA2734",
        "code": "INVALID_VIN_FORMAT",
        "path": "/build/1FMUK7DHXSGA2734",
        "requestId": "a1b2c3d4e5f6g7h8"
      }
    }
  ]
}

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