Check and search

Ask whether a product is recalled with whatever you know about it, check up to 100 products at once, or search the recall records directly.

GET /v1/check

Give at least one of these query parameters. Values are trimmed and cut at 300 characters.

How input is normalized

Response

• resolved: identifiers (kind and normalized value), brand (the compact key) and name_tokens.
• matches: up to 25, highest confidence first, then newest recall date. Each has confidence, reasons and the full recall object.

Confidence levels

The highest level found for a recall wins, and its reasons are merged. Reasons read like gtin 00041548000121, ndc 16729045715, lot 222, brand or name: protein sprout mix.

Examples from real recall records

The last one in full (long text fields shortened on this page):

Request

curl -s "https://api.recallsapi.com/v1/check?brand=Char-Broil&name=digital%20electric%20smoker" \
  -H "Authorization: Bearer $RECALLSAPI_KEY"

Response (200)

{
  "resolved": {
    "identifiers": [],
    "brand": "CHARBROIL",
    "name_tokens": [
      "digital",
      "electric",
      "smoker"
    ]
  },
  "matches": [
    {
      "confidence": "possible",
      "reasons": [
        "brand",
        "name: digital electric smoker"
      ],
      "recall": {
        "id": "cpsc-24116",
        "agency": "CPSC",
        "source": "cpsc",
        "source_id": "24116",
        "category": "consumer_product",
        "title": "Char-Broil Recalls Digital Electric Smokers Due to Risk of Electric Shock",
        "description": "This recall involves Char-Broil digital electric smokers with the following model descriptions: Digital Electric Smoker;...",
        "hazard": "The smokers can leak electrical current during use, posing an electric shock hazard.",
        "remedy": "Consumers should immediately stop using the recalled electric smokers and contact Char-Broil for a free repair kit. The ...",
        "classification": null,
        "status": null,
        "firms": [
          "Char-Broil LLC, of Columbus, Georgia"
        ],
        "products": [
          "Digital Electric Smokers"
        ],
        "distribution": "Sold at: Lowe's, Menards, Ollie's Bargain Outlet, Target and other stores nationwide, and online at Amazon.com, HSN.com ...",
        "units": "About 211,700 (In addition, 3,440 were sold in Canada)",
        "flags": [],
        "recall_date": "2024-02-15",
        "report_date": "2024-02-15",
        "url": "https://www.cpsc.gov/Recalls/2024/Char-Broil-Recalls-Digital-Electric-Smokers-Due-to-Risk-of-Electric-Shock",
        "source_url": "https://www.saferproducts.gov/RestWebServices/Recall?format=json&RecallNumber=24116",
        "as_of": "2026-10-06T01:16:49.077Z"
      }
    }
  ]
}

When nothing matches, matches is empty. That means no recall in the database carries your identifiers or a close enough brand and name; it does not certify the product as safe.

Response for name=nothing here at all (200)

{
  "resolved": {
    "identifiers": [],
    "brand": null,
    "name_tokens": [
      "nothing",
      "here"
    ]
  },
  "matches": []
}

POST /v1/check/batch

Check 1 to 100 products in one request. Each item takes the same fields as /v1/check. Each product counts as one call against your daily quota, and each result carries up to 10 matches.

Request

curl -s -X POST https://api.recallsapi.com/v1/check/batch \
  -H "Authorization: Bearer $RECALLSAPI_KEY" \
  -H "content-type: application/json" \
  -d '{"items": [{"upc": "041548000121"}, {"ndc": "16729-457-15"}]}'

The response is {"results": [...]} in the order you sent, each result being {"input", "resolved", "matches"}.

GET /v1/recalls

Search recall records. All parameters are optional.

With q, results are ranked by text relevance (title weighs most, then firms and products). Without it, newest recall date first.

Request

curl -s "https://api.recallsapi.com/v1/recalls?q=sprouts&category=food&limit=2" \
  -H "Authorization: Bearer $RECALLSAPI_KEY"

The response is {"results": [recall, ...], "next_cursor": "MjA=" | null}.

GET /v1/recalls/{id}

One recall with every identifier extracted from it. Ids are the agency recall number with a source prefix: cpsc-24116, fda-H-1339-2026, nhtsa-26V631000, fsis-025-2026. An unknown id answers 404 not_found.

Request

curl -s https://api.recallsapi.com/v1/recalls/fda-H-1339-2026 -H "Authorization: Bearer $RECALLSAPI_KEY"

Response (200)

{
  "id": "fda-H-1339-2026",
  "agency": "FDA",
  "source": "fda_food",
  "source_id": "H-1339-2026",
  "category": "food",
  "title": "Everything Sprouts, LLC: Everything Sprouts Crunchy Protein Sprout Mix, containing Alfalfa Fenugreek, Cabbage, Mung, Adzuki, Lentils, Green Pea, Net Wt",
  "description": "Everything Sprouts Crunchy Protein Sprout Mix, containing Alfalfa Fenugreek, Cabbage, Mung, Adzuki, Lentils, Green Pea, Net Wt. 5.0 oz (142 g) UPC 0 87906-01018 7.  everythingsprouts.com",
  "hazard": "Sprouts may be contaminated with STEC E. coli and/or Salmonella.",
  "remedy": null,
  "classification": "Class I",
  "status": "ongoing",
  "firms": [
    "Everything Sprouts, LLC"
  ],
  "products": [
    "Everything Sprouts Crunchy Protein Sprout Mix, containing Alfalfa Fenugreek, Cabbage, Mung, Adzuki, Lentils, Green Pea, Net Wt. 5.0 oz (142 g) UPC 0 87906-01018 7.  everythingsprouts.com"
  ],
  "distribution": "MN, WI",
  "units": "201.56 pounds",
  "flags": [],
  "recall_date": "2026-08-22",
  "report_date": "2026-09-23",
  "url": "https://api.fda.gov/food/enforcement.json?search=recall_number:%22H-1339-2026%22",
  "source_url": "https://api.fda.gov/food/enforcement.json?search=recall_number:%22H-1339-2026%22",
  "as_of": "2026-10-06T01:18:39.595Z",
  "identifiers": [
    {
      "kind": "gtin",
      "value": "00087906010187",
      "raw": "0 87906-01018 7"
    },
    {
      "kind": "gtin_cd",
      "value": "00087906010180",
      "raw": "0 87906-01018 7"
    },
    {
      "kind": "lot",
      "value": "222",
      "raw": "222"
    },
    {
      "kind": "lot",
      "value": "223",
      "raw": "223"
    },
    {
      "kind": "lot",
      "value": "226",
      "raw": "226"
    },
    {
      "kind": "lot",
      "value": "230",
      "raw": "230"
    }
  ]
}

The printed UPC 0 87906-01018 7 has a check digit that does not validate, so both the printed form and the corrected GTIN are stored.

The recall object