{"uid":"cap_cw_6D6K40PqVzMrfQ3woi","slug":"oneshot-agent-api-product-recall-lookup-8b8634ff","name":"OneShot Agent API – Product Recall Lookup","description":"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.","url":"https://win.oneshotagent.com/v1/tools/lookup/product-recalls?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"The most recalls to return. From 1 to 25. Defaults to `10`."},"title":{"type":"string","description":"Words from the recall title, for example ladder. Category consumer only. 2 to 80 characters."},"category":{"enum":["consumer","food","drug","device"],"type":"string","description":"Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration)"},"manufacturer":{"type":"string","description":"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."},"product_name":{"type":"string","description":"Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only. 2 to 80 characters."},"classification":{"enum":["Class I","Class II","Class III"],"type":"string","description":"Only recalls of this class. Categories food, drug and device only"},"recalled_after":{"type":"string","description":"Only recalls announced on or after this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."},"recalled_before":{"type":"string","description":"Only recalls announced on or before this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."}}},"responseSchema":{"type":"json","example":{"total":1,"recalls":[{"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","title":"Louisville Ladder Recalls Over One Million Attic Stairway Ladders Due to Risk of Serious Injury or Death from Fall Hazard","status":null,"hazards":["The bolts on the attic stairway ladders can break while in use, posing a risk of serious injury or death from fall hazard."],"injuries":["The firm has received 11 reports of a bolt breaking, including one report of an injury to the neck, head and back."],"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)"}],"remedies":["Consumers should stop using the recalled ladders immediately and register to receive a free repair kit."],"retailers":["The Home Depot, Lowe's, Do It Best, Orgill, and other retailers nationwide and on-line at Amazon.com"],"description":"This recall involves Louisville, Featherlite, Lite & Century Attic Stairway Ladders with gas struts only.","recalled_on":"2026-08-06","distribution":null,"manufacturers":[],"recall_number":"26661","classification":null,"remedy_options":["Repair"],"last_published_on":"2026-08-07"}],"category":"consumer"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BIL2zYyHVNmRdyvIlOH9O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up official product recalls from the CPSC and FDA by category, manufacturer, product name, or date range, returning structured recall details including hazards, injuries, remedies, and affected products.","exampleAgentPrompt":"Can you check if there are any active consumer product recalls for Louisville Ladder — look up up to 5 recalls from the CPSC and give me the hazards and remedies for each?","exampleUseCases":[{"title":"Baby product safety check","prompt":"Look up the latest 10 consumer product recalls involving baby gear or nursery furniture from the CPSC — I want to know what the hazards are and whether there are any remedies available."},{"title":"Food recall alert for a brand","prompt":"Search for any FDA food recalls mentioning 'peanut butter' from the past year — say recalled after 2024-01-01 — and tell me which firms are recalling and what the remedy options are."},{"title":"Drug recall compliance review","prompt":"Pull up the most recent Class I drug recalls from the FDA — up to 10 — so I can check if any products from our pharmacy supplier are affected."}],"resultDescription":"Returns a JSON object with a total count of matching recalls and an array of recall records. Each record includes the recall title, URL to the official recall page, recall number, recalled-on date, status, classification, list of hazards, reported injuries, affected product names and units, remedy descriptions, remedy options, retailers, manufacturers, and a product description.","failureModes":["Missing required 'category' field returns a validation error","Date range filters without a product name, title, or manufacturer may be rejected","Invalid enum values for category or classification return an error","No matching recalls returns an empty array with total=0","Manufacturer or product name containing disallowed characters may be rejected","Payment failure via x402 results in a 402 response with no data returned"],"whenToPreferThis":"Use this endpoint when an agent needs authoritative, structured recall data from U.S. regulators (CPSC or FDA) for consumer products, food, drugs, or medical devices. Prefer it over web search when you need machine-readable recall records with structured hazard, injury, remedy, and product fields. It is especially useful for safety compliance checks, consumer product research, and regulatory monitoring workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:39:20.887Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-product-recall-lookup-8b8634ff"}