curl -X POST https://win.oneshotagent.com/v1/tools/lookup/product-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"category": "consumer",
"product_name": "attic stairway",
"limit": 10
}'
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
}),
});
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);
{
"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
}
}
}
Lookups
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.
POST
/
v1
/
tools
/
lookup
/
product-recalls
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/product-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"category": "consumer",
"product_name": "attic stairway",
"limit": 10
}'
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
}),
});
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);
{
"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
}
}
}
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 thepayment-signature header.
Request Body
string
required
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.string
Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ’ & - only. 2 to 80 characters.
string
Words from the recall title, for example ladder. Category consumer only. 2 to 80 characters.
string
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.
string
Only recalls of this class. Categories food, drug and device only. One of
Class I, Class II, Class III.string
Only recalls announced on or after this date, YYYY-MM-DD. Needs a product name, title or manufacturer. Use YYYY-MM-DD.
string
Only recalls announced on or before this date, YYYY-MM-DD. Needs a product name, title or manufacturer. Use YYYY-MM-DD.
integer
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.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
product_recallsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body this call’s data comes from: US Consumer Product Safety Commission and US Food and Drug Administration, by the input.
string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
string
The category asked for.
number
How many recalls matched, including any beyond
limit.object[]
The matching recalls, newest first.
string
The regulator’s recall number.
null when the source gives no value.string
Whether the recall is ongoing, completed or terminated. Null for consumer.
null when the source gives no value.string
Class I, II or III, as the regulator classed the hazard. Null for consumer.
null when the source gives no value.string
Where the product was distributed. Null for consumer.
null when the source gives no value.string
The date the recall was announced, YYYY-MM-DD.
null when the source gives no value.string
The date the notice was last published, YYYY-MM-DD.
null when the source gives no value.string
The recall title.
null when the source gives no value.string
What was recalled.
null when the source gives no value.string
The recall notice.
null when the source gives no value.object[]
The products recalled.
string
The product name.
null when the source gives no value.string
The model.
null when the source gives no value.string
How many units, as the notice states it.
null when the source gives no value.string[]
The hazards.
string[]
What consumers are told to do.
string[]
The kinds of remedy, such as Repair or Refund.
string[]
The injuries reported.
string[]
The manufacturers.
string[]
Where it was sold.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/product-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"category": "consumer",
"product_name": "attic stairway",
"limit": 10
}'
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
}),
});
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);
{
"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 for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}