> ## Documentation Index > Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt > Use this file to discover all available pages before exploring further. # Product Recalls > List the US recalls of consumer products, food, drugs or medical devices that match a product name, a manufacturer or, for consumer products, a recall title. List the recalls of US products that match a product name, a manufacturer or, for consumer products, words from a recall title, optionally within a date range. `category` is required and picks the regulator: `consumer` is consumer products (appliances, tools, toys, furniture, ladders, bicycles, children's products and the like) from the US Consumer Product Safety Commission; `food`, `drug` and `device` are food, drugs and medical devices from the US Food and Drug Administration's enforcement reports, where `classification` (Class I, II or III) narrows the list. Vehicles are Vehicle Recalls. Each recall gives the recall number, the date it was announced and last published, what was recalled, the models and units, the hazard or reason, and the manufacturer or recalling firm. Consumer recalls also give the title, injuries, remedies, retailers and a link to the notice; food, drug and device recalls give the status, the class and where it was distributed. Newest first. Use it to check a product before a purchase, a resale, a claim or a listing. A recall says what was recalled, not whether a particular unit has been repaired. Give at least one of `product_name`, `title` and `manufacturer`; dates alone are refused. `title` is for consumer only. `total` is how many recalls matched, including any beyond `limit`, and is 0 when none did. ## Authentication Requires x402 payment in the `payment-signature` header. ## Request Body Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration). Required. One of `consumer`, `food`, `drug`, `device`. Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only. 2 to 80 characters. Words from the recall title, for example ladder. Category consumer only. 2 to 80 characters. The manufacturer, importer, distributor or retailer, for example Louisville Ladder. For food, drug and device it is the recalling firm: letters, digits, spaces and . , ' & - only. 2 to 80 characters. Only recalls of this class. Categories food, drug and device only. One of `Class I`, `Class II`, `Class III`. Only recalls announced on or after this date, YYYY-MM-DD. Needs a product name, title or manufacturer. Use YYYY-MM-DD. Only recalls announced on or before this date, YYYY-MM-DD. Needs a product name, title or manufacturer. Use YYYY-MM-DD. The most recalls to return. Default 10. From 1 to 25. Defaults to `10`. ## Response (200 OK) Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`. Durable job ID for audit and lookup Job status: `completed` Always `product_recalls` The answer, described under Result below Where the answer came from and when The public body this call's data comes from: US Consumer Product Safety Commission and US Food and Drug Administration, by the input. `public` when the data comes from a public body, `commercial` otherwise When the lookup was made, as an ISO 8601 UTC time When the source says the fact was last updated, or `null` when the source gives no date ## Result Nested under `data.result`. The category asked for. How many recalls matched, including any beyond `limit`. The matching recalls, newest first. The regulator's recall number. `null` when the source gives no value. Whether the recall is ongoing, completed or terminated. Null for consumer. `null` when the source gives no value. Class I, II or III, as the regulator classed the hazard. Null for consumer. `null` when the source gives no value. Where the product was distributed. Null for consumer. `null` when the source gives no value. The date the recall was announced, YYYY-MM-DD. `null` when the source gives no value. The date the notice was last published, YYYY-MM-DD. `null` when the source gives no value. The recall title. `null` when the source gives no value. What was recalled. `null` when the source gives no value. The recall notice. `null` when the source gives no value. The products recalled. The product name. `null` when the source gives no value. The model. `null` when the source gives no value. How many units, as the notice states it. `null` when the source gives no value. The hazards. What consumers are told to do. The kinds of remedy, such as Repair or Refund. The injuries reported. The manufacturers. Where it was sold. ```bash cURL theme={null} curl -X POST https://win.oneshotagent.com/v1/tools/lookup/product-recalls \ -H "Content-Type: application/json" \ -H "payment-signature: " \ -d '{ "category": "consumer", "product_name": "attic stairway", "limit": 10 }' ``` ```javascript JavaScript theme={null} const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/product-recalls", { method: "POST", headers: { "Content-Type": "application/json", "payment-signature": paymentProof, }, body: JSON.stringify({ "category": "consumer", "product_name": "attic stairway", "limit": 10 }), }); ``` ```typescript SDK theme={null} const result = await agent.tool('lookup/product-recalls', { category: 'consumer', product_name: 'attic stairway', limit: 10 }); console.log(result.data.result); console.log(result.data.evidence); ``` ```json Response (200) theme={null} { "success": true, "data": { "request_id": "uuid", "receipt_id": "rcpt_...", "status": "completed", "tool": "product_recalls", "result": { "category": "consumer", "total": 1, "recalls": [ { "recall_number": "26661", "status": null, "classification": null, "distribution": null, "recalled_on": "2026-08-06", "last_published_on": "2026-08-07", "title": "Louisville Ladder Recalls Over One Million Attic Stairway Ladders Due to Risk of Serious Injury or Death from Fall Hazard", "description": "This recall involves Louisville, Featherlite, Lite & Century Attic Stairway Ladders with gas struts only.", "url": "https://www.cpsc.gov/Recalls/2026/Louisville-Ladder-Recalls-Over-One-Million-Attic-Stairway-Ladders-Due-to-Risk-of-Serious-Injury-or-Death-from-Fall-Hazard", "products": [ { "name": "Louisville, Featherlite, Lite & Century Attic Stairway Ladders with gas struts", "model": null, "units": "1,770,000 (In addition, about 13,054 were sold in Canada)" } ], "hazards": [ "The bolts on the attic stairway ladders can break while in use, posing a risk of serious injury or death from fall hazard." ], "remedies": [ "Consumers should stop using the recalled ladders immediately and register to receive a free repair kit." ], "remedy_options": [ "Repair" ], "injuries": [ "The firm has received 11 reports of a bolt breaking, including one report of an injury to the neck, head and back." ], "manufacturers": [], "retailers": [ "The Home Depot, Lowe's, Do It Best, Orgill, and other retailers nationwide and on-line at Amazon.com" ] } ] }, "evidence": { "source": "US Consumer Product Safety Commission", "source_kind": "public", "retrieved_at": "2026-01-15T12:00:00.000Z", "as_of": null } } } ``` Price: \$0.005 per lookup. See [Pricing](/pricing) for every tool. ## Notes * Results return inline. The finished job stays available at `/v1/requests/{request_id}` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.