# Vehicle Recalls (NHTSA) (`vin.recalls`)

NHTSA safety recalls for a vehicle model, by VIN or by make, model and model year: campaign number, component, summary, consequence, remedy and park-it advisories, newest first.

Docs: https://primaryapi.com/docs/api-reference/vin/recalls

- Endpoint: `POST https://api.primaryapi.com/v1/run/vin.recalls`
- Category: Knowledge & Data · Platform: `vin` · Kind: list · Status: live
- Price: 1 credit per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=vin.recalls`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `vin` | string | no |  | pattern: ^[A-HJ-NPR-Z0-9]{17}$ | 17-character VIN. It is decoded to make, model and model year, and recalls are listed for that vehicle model (not this exact car). |
| `make` | string | no |  | max 50 chars | Vehicle make, e.g. "honda" (with model and modelYear, when no VIN is given). |
| `model` | string | no |  | max 60 chars | Vehicle model, e.g. "accord". |
| `modelYear` | integer | no |  | 1949–2100 | Model year, e.g. 2003. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `vehicle` | object | The vehicle model the recalls were looked up for |
| `vehicle.vin` | string \| null | The VIN given (upper case), null for a make/model/year call |
| `vehicle.make` | string |  |
| `vehicle.model` | string |  |
| `vehicle.modelYear` | integer |  |
| `count` | integer | Recalls listed |
| `recalls` | object[] | Recalls for the model, newest report first |
| `recalls[].agency` | enum | Agency that published the recall |
| `recalls[].recallId` | string | Agency recall id: CPSC recall number, FDA recall number, NHTSA campaign number |
| `recalls[].date` | string | Recall date (CPSC), report date (FDA) or report received date (NHTSA), YYYY-MM-DD |
| `recalls[].title` | string | Recall title (CPSC), "<firm>: <product>" (FDA) or the component (NHTSA) |
| `recalls[].category` | string \| null | CPSC product type, FDA category (drug, device, food) or "vehicle" (NHTSA) |
| `recalls[].classification` | string \| null | FDA recall class (Class I is the most serious); null for other agencies |
| `recalls[].status` | string \| null | FDA recall status (Ongoing, Completed, Terminated); null for other agencies |
| `recalls[].firms` | string[] | Recalling firm(s): manufacturer, importer or distributor names |
| `recalls[].products` | string[] | Product names (NHTSA: "MAKE MODEL YEAR") |
| `recalls[].hazard` | string \| null | Hazard (CPSC), reason for recall (FDA) or consequence (NHTSA) |
| `recalls[].remedy` | string \| null | What owners should do (CPSC, NHTSA); null for FDA |
| `recalls[].description` | string \| null | Description (CPSC), product description (FDA) or summary (NHTSA) |
| `recalls[].units` | string \| null | Units affected as published, e.g. "About 265,000" or "18,991 vials" |
| `recalls[].url` | string \| null | Agency recall notice URL when the agency publishes one (CPSC) |
| `recalls[].campaignNumber` | string | NHTSA campaign number, e.g. "19V182000" (same as recallId) |
| `recalls[].manufacturer` | string \| null | Manufacturer that filed the recall |
| `recalls[].component` | string \| null | Affected component, e.g. "AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE" |
| `recalls[].summary` | string \| null |  |
| `recalls[].consequence` | string \| null |  |
| `recalls[].notes` | string \| null |  |
| `recalls[].nhtsaActionNumber` | string \| null | Related NHTSA investigation, e.g. "EA15001" |
| `recalls[].parkIt` | boolean \| null | NHTSA advises not to drive the vehicle until repaired |
| `recalls[].parkOutside` | boolean \| null | NHTSA advises parking outside (fire risk) until repaired |
| `recalls[].overTheAirUpdate` | boolean \| null | The remedy is delivered over the air |
| `nextCursor` | null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/vin.recalls" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"honda","model":"accord","modelYear":2003}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "vehicle": {
        "vin": null,
        "make": "HONDA",
        "model": "ACCORD",
        "modelYear": 2003
      },
      "count": 24,
      "recalls": [
        {
          "agency": "nhtsa",
          "recallId": "19E068000",
          "date": "2019-10-10",
          "title": "VEHICLE SPEED CONTROL:ACCELERATOR PEDAL",
          "category": "vehicle",
          "classification": null,
          "status": null,
          "firms": [
            "Dorman Products, Inc."
          ],
          "products": [
            "HONDA ACCORD 2003"
          ],
          "hazard": "If the accelerator pedal binds, the engine may not quickly return to idle after the pedal is no longer pressed, increasing the risk of a crash.",
          "remedy": "Dorman will notify owners, and qualified service facilities will replace the affected accelerator pedal assemblies, free of charge.  The recall began December 9, 2019.  Owners may contact Dorman customer service at 1-800-523-2492, using option 5.  Dorman's number for this recall is AS1019XXXX.",
          "description": "Dorman Products, Inc.  (Dorman) is recalling certain Accelerator Pedal Assemblies part numbers 699-114 and 825-5029-1, sold as replacement parts for 2003-2006 Acura MDX, 2004-2008 Acura TL and TSX, 2003-2007 Honda Accord, 2005-2006 Honda CR-V, 2007-2011 Honda Element, 2005-2008 Honda Pilot and 2006-2014 Honda Ridgeline vehicles.  The rotating portion of the accelerator pedal assembly may bind. As such, these vehicles fail to comply with the requirements of Federal Motor Vehicle Safety Standard (FMVSS) number 124, \"Accelerator Control Systems.\"",
          "units": null,
          "url": null,
          "campaignNumber": "19E068000",
          "manufacturer": "Dorman Products, Inc.",
          "component": "VEHICLE SPEED CONTROL:ACCELERATOR PEDAL",
          "summary": "Dorman Products, Inc.  (Dorman) is recalling certain Accelerator Pedal Assemblies part numbers 699-114 and 825-5029-1, sold as replacement parts for 2003-2006 Acura MDX, 2004-2008 Acura TL and TSX, 2003-2007 Honda Accord, 2005-2006 Honda CR-V, 2007-2011 Honda Element, 2005-2008 Honda Pilot and 2006-2014 Honda Ridgeline vehicles.  The rotating portion of the accelerator pedal assembly may bind. As such, these vehicles fail to comply with the requirements of Federal Motor Vehicle Safety Standard (FMVSS) number 124, \"Accelerator Control Systems.\"",
          "consequence": "If the accelerator pedal binds, the engine may not quickly return to idle after the pedal is no longer pressed, increasing the risk of a crash.",
          "notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236 (TTY 1-800-424-9153), or go to www.safercar.gov.",
          "nhtsaActionNumber": null,
          "parkIt": null,
          "parkOutside": null,
          "overTheAirUpdate": null
        }
      ],
      "nextCursor": null
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=vin.recalls`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Recalls are listed per vehicle model and year (NHTSA does not publish per-VIN repair status in this API). A VIN costs the same as make/model/year; one that cannot be decoded to a make, model and year is a free miss (reason vin_not_decoded). Rows use the same item shape as recalls.search (agency "nhtsa") plus NHTSA fields. Newest report first, ties by campaign number. A new campaign for the model changes the output, so a monitor on a VIN reports it.

## Legal

Source: U.S. National Highway Traffic Safety Administration recalls (https://www.nhtsa.gov), US government public data. Recalls are listed per vehicle model and year, not per VIN: they do not say whether a specific vehicle has been repaired.

