Decode VINs in Bulk

Look up many VINs in one call. The answer holds one item per VIN, in the order sent: exactly what GET /vin/{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 your 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 /vin/{vin} call, once per VIN per day; the bulk call itself is not counted. A 207 (a partial decode) is not counted, as on GET /vin/{vin}. On the Free plan the call answers no more VINs than the month's free calls left; each VIN past them is a 429 item with limitType: quota, as its single call would be.

POST
/vin/bulk
AuthorizationBearer <token>

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

In: header

Query Parameters

ambiguity?boolean

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.

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/vin/bulk?ambiguity=false" \  -H "Content-Type: application/json" \  -d '{    "vins": [      "3GCUDHEL3NG668790",      "1FMUK7DHXSGA27346"    ]  }'

{
  "bulk": {
    "id": "6f1c0d52-3a4e-4a8e-9a43-0c4b0d1f2e3a",
    "endpoint": "vin",
    "requested": 2,
    "answered": 1,
    "failed": 1,
    "byStatus": {
      "200": 1,
      "404": 1
    },
    "retry": [],
    "ms": 412
  },
  "results": [
    {
      "vin": "3GCUDHEL3NG668790",
      "statusCode": 200,
      "vinValid": true,
      "wmi": "3GC",
      "origin": "Mexico",
      "squishVin": "3GCUDHELNG",
      "checkDigit": "3",
      "checksum": true,
      "type": "Active",
      "make": "Chevrolet",
      "model": "Silverado 1500",
      "trim": "ZR2",
      "style": "4x4 4dr Crew Cab 5.8 ft. SB",
      "body": "Truck",
      "engine": "5.3L V8 OHV 16V FFV",
      "drive": "4WD",
      "transmission": "Automatic",
      "doors": 4,
      "fuel": "Flex-fuel",
      "vehicle": {
        "vin": "3GCUDHEL3NG668790",
        "year": 2022,
        "make": "Chevrolet",
        "model": "Silverado 1500",
        "manufacturer": "General Motors de Mexico"
      },
      "ambiguous": false
    },
    {
      "vin": "1FMUK7DHXSGA27346",
      "statusCode": 404,
      "vinValid": false,
      "error": {
        "status": 404,
        "error": "Failed to decode VIN: 1FMUK7DHXSGA27346",
        "code": "VIN_NOT_FOUND",
        "path": "/vin/1FMUK7DHXSGA27346",
        "requestId": "a1b2c3d4e5f6g7h8"
      }
    }
  ]
}

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