curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-recalls', {
make: 'Honda',
model: 'CR-V',
model_year: 2019,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_recalls",
"result": {
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"total": 8,
"recalls": [
{
"campaign_number": "19V865000",
"reported_on": "2019-12-05",
"component": "STRUCTURE:FRAME AND MEMBERS",
"summary": "Honda (American Honda Motor Co.) is recalling certain 2019-2020 CR-V vehicles. The rear subframe bolts were improperly manufactured and may loosen, allowing the rear subframe to separate.",
"consequence": "A separated rear subframe reduces vehicle handling and can suddenly disable the vehicle, increasing the risk of a crash.",
"remedy": "Honda will notify owners, and dealers will inspect the rear subframe bolts and retorque them or replace them, as necessary, free of charge.",
"notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236.",
"manufacturer": "Honda (American Honda Motor Co.)",
"park_it": false,
"park_outside": false,
"over_the_air_fix": false
}
]
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Vehicle Recalls
List the safety recalls issued for a vehicle make, model and model year.
POST
/
v1
/
tools
/
lookup
/
vehicle-recalls
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-recalls', {
make: 'Honda',
model: 'CR-V',
model_year: 2019,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_recalls",
"result": {
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"total": 8,
"recalls": [
{
"campaign_number": "19V865000",
"reported_on": "2019-12-05",
"component": "STRUCTURE:FRAME AND MEMBERS",
"summary": "Honda (American Honda Motor Co.) is recalling certain 2019-2020 CR-V vehicles. The rear subframe bolts were improperly manufactured and may loosen, allowing the rear subframe to separate.",
"consequence": "A separated rear subframe reduces vehicle handling and can suddenly disable the vehicle, increasing the risk of a crash.",
"remedy": "Honda will notify owners, and dealers will inspect the rear subframe bolts and retorque them or replace them, as necessary, free of charge.",
"notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236.",
"manufacturer": "Honda (American Honda Motor Co.)",
"park_it": false,
"park_outside": false,
"over_the_air_fix": false
}
]
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
List the safety recalls issued for a vehicle by make, model and model year: the campaign number, the date it was reported, the affected component, what is wrong, the risk, the remedy and whether the owner is told to park the vehicle. Use it to check a used vehicle before a purchase, a loan, a claim or a fleet decision. Covers vehicles sold in the United States. These are the recalls issued for the model. The result does not say whether a particular vehicle has had the repair done. To start from a vehicle identification number, decode it first with Vehicle Identification, which returns the make, model and year.
total is 0 when the model has no recalls.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only.
string
required
The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only.
integer
required
The model year, from 1950 to next year. At least 1950. Model year cannot be later than next year.
integer
The most recalls to return. Default 25. From 1 to 50. Defaults to
25.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
vehicle_recallsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US National Highway Traffic Safety Administration.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
Make.
string
Model.
number
Model year.
number
How many recalls were issued for the model, including any beyond
limit.object[]
Recalls.
string
The agency campaign number.
null when the source gives no value.string
The date the manufacturer reported the recall, YYYY-MM-DD.
null when the source gives no value.string
Component.
null when the source gives no value.string
What is wrong.
null when the source gives no value.string
The risk to the driver.
null when the source gives no value.string
What the manufacturer will do about it.
null when the source gives no value.string
Notes.
null when the source gives no value.string
Manufacturer.
null when the source gives no value.boolean
True when owners are told not to drive the vehicle.
boolean
True when owners are told to park the vehicle outside.
boolean
True when the remedy is a software update sent to the vehicle.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-recalls", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-recalls', {
make: 'Honda',
model: 'CR-V',
model_year: 2019,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_recalls",
"result": {
"make": "Honda",
"model": "CR-V",
"model_year": 2019,
"total": 8,
"recalls": [
{
"campaign_number": "19V865000",
"reported_on": "2019-12-05",
"component": "STRUCTURE:FRAME AND MEMBERS",
"summary": "Honda (American Honda Motor Co.) is recalling certain 2019-2020 CR-V vehicles. The rear subframe bolts were improperly manufactured and may loosen, allowing the rear subframe to separate.",
"consequence": "A separated rear subframe reduces vehicle handling and can suddenly disable the vehicle, increasing the risk of a crash.",
"remedy": "Honda will notify owners, and dealers will inspect the rear subframe bolts and retorque them or replace them, as necessary, free of charge.",
"notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236.",
"manufacturer": "Honda (American Honda Motor Co.)",
"park_it": false,
"park_outside": false,
"over_the_air_fix": false
}
]
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"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}