# Product Recalls (CPSC and FDA) (`recalls.search`)

US product recalls across agencies in one schema: CPSC consumer-product recalls and FDA drug, device and food enforcement reports, newest first, filtered by agency, firm, text and date.

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

- Endpoint: `POST https://api.primaryapi.com/v1/run/recalls.search`
- Category: Compliance & Records · Platform: `recalls` · 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=recalls.search`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `agency` | enum | no |  | one of: cpsc, fda | Only this agency: cpsc (consumer products) or fda (drugs, medical devices, foods). Omit for every agency. |
| `firm` | string | no |  | max 120 chars | Firm name: for CPSC the recall title, manufacturer, importer or distributor contains it; for FDA a phrase match on the recalling firm. |
| `query` | string | no |  | max 120 chars | Text to find: for CPSC every word must appear in the title, product, description or hazard; for FDA a phrase match on the product description or the reason for recall. |
| `dateFrom` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only records whose recall date is on or after this date (YYYY-MM-DD). Default: 90 days before dateTo. |
| `dateTo` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only records whose recall date is on or before this date (YYYY-MM-DD). Default: today (UTC). |
| `limit` | integer | no | 25 | 1–100 | Maximum number of results to return (1-100, default 25). |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

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 |
|---|---|---|
| `recalls` | object[] | Matching recalls from every agency in scope, newest 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) |
| `nextCursor` | string \| 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.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/recalls.search" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency":"cpsc","firm":"Allstar","dateFrom":"2026-10-15","dateTo":"2026-11-15","limit":1}'
```

## 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": {
      "recalls": [
        {
          "agency": "cpsc",
          "recallId": "27082",
          "date": "2026-11-12",
          "title": "Allstar Recalls Sharper Image Tabletop and Infinity Fire Pits Due to Risk of Serious Injury from Burn and Fire Hazards",
          "category": "Outdoor Patio Heaters or Firepits (Manufactured)",
          "classification": null,
          "status": null,
          "firms": [
            "Allstar Marketing Group, LLC, of Winston-Salem, North Carolina"
          ],
          "products": [
            "Sharper Image Tabletop Fire Pits and Sharper Image Tabletop Infinity Fire Pits"
          ],
          "hazard": "Ignited flammable liquid can escape from the recalled fire pits or trigger flame jetting from the fuel containers, posing a risk of serious injury from burn and fire hazards.",
          "remedy": "Consumers should stop using the recalled fire pits immediately and contact Allstar for a full refund. Consumers will be asked to register at www.firepitrecall.expertinquiry.com, write “RECALLED – DO NOT USE” in permanent marker, and submit three photographs following the instructions on Allstar’s recall page. After registration is confirmed, consumers should dispose of any remaining fuel in accordance with local hazardous-waste requirements and discard the recalled fire pits safely.",
          "description": "This recall involves outdoor Sharper Image-Branded Tabletop Fire Pits and Sharper Image-Branded Tabletop Infinity Fire Pits. The units have a “77” logo on the front, a Lot Code sticker in the center of the base, a round black sticker marked “CHINA” with a 5-digit code, the letters KS-CY or KS-FC, and a date code in YYYY-MM-DD format. The Sharper Image-Branded Tabletop Fire Pits feature a small cylindrical concrete body with a removable snuffing lid and an open burn chamber at the top. The Sharper Image-Branded Tabletop Infinity Fire Pits feature a steel base and tempered‑glass side panels.",
          "units": "About 265,000",
          "url": "https://www.cpsc.gov/Recalls/2027/Allstar-Recalls-Sharper-Image-Tabletop-and-Infinity-Fire-Pits-Due-to-Risk-of-Serious-Injury-from-Burn-and-Fire-Hazards"
        }
      ],
      "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=recalls.search`

## 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

CPSC publishes recalls as they are announced; FDA enforcement reports are weekly. Newest first across agencies (date, then recall id, descending). Without dateFrom the window is the 90 days up to dateTo (default today, UTC); the response hint says so. For a monitor, pin dateFrom to a fixed date (for example the day you create it): the output then changes only when a record is added or updated, never because an old one ages out of a rolling window. One call covers at most 1096 days (CPSC returns every match of a window at once). For vehicles use vin.recalls (same item shape). Empty results are free.

## Legal

Sources: U.S. Consumer Product Safety Commission recalls (https://www.cpsc.gov) and U.S. Food and Drug Administration enforcement reports (openFDA, https://open.fda.gov), US government public data. openFDA: "Do not rely on openFDA to make decisions regarding medical care. While we make every effort to ensure that data is accurate, you should assume all results are unvalidated." Check the agency notice before acting on a recall.

