About this endpoint
What it does
Decodes up to 50 VINs and/or checks up to 20 vehicles for recalls in one call. When enabled, the response includes recall data alongside the decoded specs for each result row.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| vins | String Array | No | Vehicle identification numbers, 17 characters each, with no letters I, O, or Q. Up to 50 per run. A malformed VIN returns a row with status invalid_format and is not sent upstream. VINs of US market vehicles decode best. |
| vehicles | String Array | No | Optional vehicles to check for recalls without a VIN, up to 20 per run. Each entry can be a text value like 2019 honda accord or an object like {"year": 2019, "make": "land rover", "model": "range rover"} for makes with several words. |
| includeRecalls | Boolean | No | If true, every decoded VIN or vehicle includes NHTSA recalls attached (recallCount and the recalls list). Turn off to get only the decoded specs. Always on in Only new recalls mode. |
Response
Returns a JSON object with three top-level fields: billed (integer), count (integer), and items (array). billed is the number of units charged for the call, count is the number of rows in items, and items contains the result rows.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| billed | Integer | Yes | Units charged for this call: result rows only; not-found / unavailable / invalid rows are free. |
| count | Integer | Yes | Number of rows in items. |
| items | Object Array | Yes | Result rows returned by the endpoint. |



