curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-complaints', {
make: 'Fiat',
model: '124 Spider',
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_complaints",
"result": {
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"total": 9,
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0,
"components": [
{
"component": "SEAT BELTS",
"complaints": 3
},
{
"component": "FUEL/PROPULSION SYSTEM",
"complaints": 2
},
{
"component": "ENGINE",
"complaints": 1
},
{
"component": "FUEL SYSTEM, GASOLINE",
"complaints": 1
},
{
"component": "UNKNOWN OR OTHER",
"complaints": 1
}
],
"complaints": [
{
"id": 11578356,
"filed_on": "2024-03-19",
"incident_on": "2024-03-19",
"components": [
"SEAT BELTS"
],
"crash": false,
"fire": false,
"injuries": 0,
"deaths": 0,
"summary": "The seat belts do not retract properly, causing a loose seat belt. The vehicle has 10,000 miles on it. This is a common problem with all 2017 to 2020 Fiat Spiders. Replacement seat belt retractors have the same problem."
}
]
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Vehicle Complaints
Summarize the safety complaints owners filed for a vehicle make, model and model year, with the newest ones.
POST
/
v1
/
tools
/
lookup
/
vehicle-complaints
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-complaints', {
make: 'Fiat',
model: '124 Spider',
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_complaints",
"result": {
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"total": 9,
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0,
"components": [
{
"component": "SEAT BELTS",
"complaints": 3
},
{
"component": "FUEL/PROPULSION SYSTEM",
"complaints": 2
},
{
"component": "ENGINE",
"complaints": 1
},
{
"component": "FUEL SYSTEM, GASOLINE",
"complaints": 1
},
{
"component": "UNKNOWN OR OTHER",
"complaints": 1
}
],
"complaints": [
{
"id": 11578356,
"filed_on": "2024-03-19",
"incident_on": "2024-03-19",
"components": [
"SEAT BELTS"
],
"crash": false,
"fire": false,
"injuries": 0,
"deaths": 0,
"summary": "The seat belts do not retract properly, causing a loose seat belt. The vehicle has 10,000 miles on it. This is a common problem with all 2017 to 2020 Fiat Spiders. Replacement seat belt retractors have the same problem."
}
]
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Summarize what owners have reported to the US safety regulator about a vehicle by make, model and model year: how many complaints there are, how many involved a crash, a fire, injuries or deaths, which components are reported most, and the newest complaints with their dates, components and the owner’s own words. 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. Complaints are reports by owners, not findings by the regulator. A complaint does not show that the vehicle has a defect, and a model with few complaints is not proven free of one. To see the safety recalls instead, use Vehicle Recalls.
total is 0 when the model has no complaints.
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 complaints to return, newest first. 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
vehicle_complaintsobject
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 complaints were filed for the model, including any beyond
limit.number
How many of all the complaints say a crash was involved.
number
How many of all the complaints say a fire was involved.
number
The injuries reported across all the complaints.
number
The deaths reported across all the complaints.
object[]
The five components named most often, across all the complaints.
string
The vehicle component named in the complaints.
number
How many of all the complaints name it.
object[]
The newest complaints, up to
limit.number
The agency complaint number.
null when the source gives no value.string
The date the complaint was filed, YYYY-MM-DD.
null when the source gives no value.string
The date of the incident the owner describes, YYYY-MM-DD.
null when the source gives no value.string[]
The components the owner names.
boolean
True when the owner reports a crash.
boolean
True when the owner reports a fire.
number
Injuries.
number
Deaths.
string
The owner’s account, cut to 500 characters.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"limit": 1
}),
});
const result = await agent.tool('lookup/vehicle-complaints', {
make: 'Fiat',
model: '124 Spider',
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_complaints",
"result": {
"make": "Fiat",
"model": "124 Spider",
"model_year": 2019,
"total": 9,
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0,
"components": [
{
"component": "SEAT BELTS",
"complaints": 3
},
{
"component": "FUEL/PROPULSION SYSTEM",
"complaints": 2
},
{
"component": "ENGINE",
"complaints": 1
},
{
"component": "FUEL SYSTEM, GASOLINE",
"complaints": 1
},
{
"component": "UNKNOWN OR OTHER",
"complaints": 1
}
],
"complaints": [
{
"id": 11578356,
"filed_on": "2024-03-19",
"incident_on": "2024-03-19",
"components": [
"SEAT BELTS"
],
"crash": false,
"fire": false,
"injuries": 0,
"deaths": 0,
"summary": "The seat belts do not retract properly, causing a loose seat belt. The vehicle has 10,000 miles on it. This is a common problem with all 2017 to 2020 Fiat Spiders. Replacement seat belt retractors have the same problem."
}
]
},
"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}