# FDA Recall Enforcement Reports (`fda.recalls`)

FDA recall enforcement reports for drugs, medical devices and foods: recalling firm, product, reason, class and status, newest first, filtered by firm, product, class, status and date.

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

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

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `category` | enum | no |  | one of: drug, device, food | Only this product category: drug, device or food. Omit for all three, merged newest first. |
| `firm` | string | no |  | max 120 chars | Recalling firm name, phrase match, for example "Medtronic" or "Par Health". |
| `product` | string | no |  | max 120 chars | Words in the product description, phrase match, for example "insulin pump". |
| `classification` | enum | no |  | one of: I, II, III | Recall class: I (the product can cause serious harm or death), II or III (least serious). |
| `status` | enum | no |  | one of: ongoing, completed, terminated | Recall status as reported to FDA. |
| `recallNumber` | string | no |  | pattern: ^[A-Z]-\d{4}-\d{4}$ | Exact FDA recall number, for example "D-0082-2027" (the window still applies). |
| `dateFrom` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only records whose report 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 report 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 enforcement reports, newest report date first |
| `recalls[].recallNumber` | string | FDA recall number, e.g. "D-0082-2027" (D drugs, Z devices, F/H foods) |
| `recalls[].category` | enum | Product category of the enforcement report |
| `recalls[].classification` | string \| null | "Class I", "Class II", "Class III" or "Not Yet Classified" |
| `recalls[].status` | string \| null | Ongoing, Completed or Terminated |
| `recalls[].reportDate` | string | Date the recall appeared in the weekly enforcement report, YYYY-MM-DD |
| `recalls[].recallInitiationDate` | string \| null | Date the firm started the recall, YYYY-MM-DD |
| `recalls[].classificationDate` | string \| null | Date FDA classified the recall, YYYY-MM-DD |
| `recalls[].terminationDate` | string \| null | Date FDA terminated the recall, YYYY-MM-DD |
| `recalls[].firm` | string \| null | Recalling firm |
| `recalls[].firmCity` | string \| null |  |
| `recalls[].firmState` | string \| null |  |
| `recalls[].firmCountry` | string \| null |  |
| `recalls[].productType` | string \| null | Drugs, Devices, Food/Cosmetics … |
| `recalls[].productDescription` | string \| null |  |
| `recalls[].productQuantity` | string \| null | Quantity in commerce as reported, e.g. "18,991 vials" |
| `recalls[].reasonForRecall` | string \| null |  |
| `recalls[].codeInfo` | string \| null | Lot, serial or code information (cut at 2,000 characters) |
| `recalls[].distributionPattern` | string \| null |  |
| `recalls[].voluntaryMandated` | string \| null | e.g. "Voluntary: Firm initiated" |
| `recalls[].initialFirmNotification` | string \| null | How the firm first notified customers, e.g. "Letter" |
| `recalls[].eventId` | string \| null | FDA recall event id (one event can hold several recall numbers) |
| `recalls[].brandNames` | string[] | Brand names FDA linked to the product (drugs mostly) |
| `recalls[].genericNames` | string[] |  |
| `recalls[].productNdcs` | string[] | NDC product codes FDA linked to the product (drugs) |
| `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/fda.recalls" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"drug","classification":"I","dateFrom":"2026-08-01","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": [
        {
          "recallNumber": "D-0082-2027",
          "category": "drug",
          "classification": "Class I",
          "status": "Ongoing",
          "reportDate": "2026-10-28",
          "recallInitiationDate": "2026-10-13",
          "classificationDate": "2026-10-26",
          "terminationDate": null,
          "firm": "Par Health USA, LLC",
          "firmCity": "Rochester",
          "firmState": "MI",
          "firmCountry": "United States",
          "productType": "Drugs",
          "productDescription": "Argatroban Injection, USP, 250 mg/2.5mL (100 mg/mL), 2.5 mL x 1 Single Dose Vial, Rx only, Manufactured for: Endo USA, Malvern,PA 19355/Argatroban Injection, 250 mg/2.5mL (100 mg/mL), 2.5 mL x 1 Single Dose Vial, Rx only,  Distributed by: Par Pharmaceutical, Chestnut Ridge, NY 10977, NDC 42023-182-01.",
          "productQuantity": "18,991 vials",
          "reasonForRecall": "Particulate matter: particulate matter identified as cellulose, polystyrene, polyethylene teraphalate, stainless steel, or stopper material in the product solution.",
          "codeInfo": "Lot #: 83449, Exp Date: 10/2026; 82682, Exp Date: 11/2026; 86714, 87302, 87560, Exp Date: 02/2027; 87753, 88401, Exp Date: 03/2027; 88614, 88836, Exp Date: 04/2027; 90220, Exp Date: 05/2027; 91216, 91219, Exp Date: 06/2027; 92004, 92006, Exp Date: 07/2027; 92009, 92596, 92782, 93107, 93329, Exp Date: 08/2027; 93890, Exp Date: 09/2027.",
          "distributionPattern": "Nationwide within the United States",
          "voluntaryMandated": "Voluntary: Firm initiated",
          "initialFirmNotification": "Press Release",
          "eventId": "100072",
          "brandNames": [
            "ARGATROBAN"
          ],
          "genericNames": [
            "ARGATROBAN"
          ],
          "productNdcs": [
            "42023-182"
          ]
        }
      ],
      "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=fda.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

Weekly FDA enforcement reports (records from 2004; a recall appears once FDA classifies it). Filters combine with AND; firm and product are phrase matches. Newest report date first, ties by recall number (descending), so the order is stable between runs. 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. Paging stops after 25,000 records per category. Empty results are free.

## Legal

Data provided by the U.S. Food and Drug Administration (openFDA, https://open.fda.gov), public domain (CC0). 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." FDA states that enforcement-report data should not be used as a method to collect data to issue alerts to the public, and that it does not update a recall's status after the recall is classified. Not medical advice.

