Vehicle Recalls & VIN Decoder API
Decode up to 50 VINs per call with the official NHTSA vPIC database (make, model, year, trim, engine, drive, plant, safety equipment) and attach the open NHTSA recalls for each vehicle. Also look up recalls by year, make and model. Fleet recall monitor mode returns only recalls not seen before. An NHTSA outage is reported as unavailable, never as no recalls.
Example request
curl -X POST https://radarbg.com/v1/vehicle-recalls-vin-decoder \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"vins": ["1HGCV1F35KA000001", "1FTFW1ET9DFC10312"], "vehicles": ["2019 honda accord", {"year": 2021, "make": "ford", "model": "f-150"}], "includeRecalls": true, "onlyNew": false}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
vins | array | Vehicle identification numbers (17 characters, no letters I, O, 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 | array | Optional. Vehicles to check for recalls without a VIN, up to 20 per run. Each entry is a text like 2019 honda accord (year, one-word make, model) or an object {"year": 2019, "make": "land rover", "model": "range rover"} for makes with sever |
includeRecalls | boolean | If on, every decoded VIN or vehicle gets its NHTSA recalls attached (recallCount and the recalls list). Turn off to get only the decoded specs. Always on in Only new recalls mode. |
onlyNew | boolean | Return one row per recall that was not seen before for this Monitor ID (the first run returns all current recalls). Use it on a schedule to watch a fleet or a dealer stock. |
monitorId | string | Name of the fleet watch list for Only new recalls mode, e.g. my-fleet. Each Monitor ID keeps its own memory. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.