# OneShot Agent API – Product Recall Lookup

> OneShot Agent API – Product Recall Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

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.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/product-recalls?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-product-recall-lookup-8b8634ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cw_6D6K40PqVzMrfQ3woi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-product-recall-lookup-8b8634ff -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-product-recall-lookup-8b8634ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)