curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}),
});
const result = await agent.tool('lookup/vehicle-crash-ratings', {
model_year: 2024,
make: 'Toyota',
model: 'Camry',
variant: 'FWD'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_crash_ratings",
"result": {
"variants": [
{
"vehicle_id": 19427,
"description": "2024 Toyota CAMRY 4 DR AWD"
},
{
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD"
}
],
"rated": true,
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD",
"overall_rating": 5,
"front_crash_rating": 5,
"front_driver_rating": 5,
"front_passenger_rating": 5,
"side_crash_rating": 5,
"side_driver_rating": 5,
"side_passenger_rating": 5,
"side_pole_rating": 5,
"rollover_rating": 5,
"rollover_risk": 0.099,
"tip_result": "No Tip",
"electronic_stability_control": "Standard",
"forward_collision_warning": "Standard",
"lane_departure_warning": "Standard",
"complaints_count": 51,
"recalls_count": 1,
"investigations_count": 0
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Products & vehicles
Crash Ratings
Give the federal crash test star ratings of a vehicle make, model and model year.
POST
/
v1
/
tools
/
lookup
/
vehicle-crash-ratings
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}),
});
const result = await agent.tool('lookup/vehicle-crash-ratings', {
model_year: 2024,
make: 'Toyota',
model: 'Camry',
variant: 'FWD'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_crash_ratings",
"result": {
"variants": [
{
"vehicle_id": 19427,
"description": "2024 Toyota CAMRY 4 DR AWD"
},
{
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD"
}
],
"rated": true,
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD",
"overall_rating": 5,
"front_crash_rating": 5,
"front_driver_rating": 5,
"front_passenger_rating": 5,
"side_crash_rating": 5,
"side_driver_rating": 5,
"side_passenger_rating": 5,
"side_pole_rating": 5,
"rollover_rating": 5,
"rollover_risk": 0.099,
"tip_result": "No Tip",
"electronic_stability_control": "Standard",
"forward_collision_warning": "Standard",
"lane_departure_warning": "Standard",
"complaints_count": 51,
"recalls_count": 1,
"investigations_count": 0
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Give the federal crash test star ratings of a vehicle by make, model and model year: the overall rating, the frontal and side crash ratings for the driver and the passenger, the side pole rating, the rollover rating with the rollover risk, and whether electronic stability control, forward collision warning and lane departure warning are standard or optional. The result also lists every rated variant of the model year, with the identifier the source gives each, so a second call with
variant can rate another one. Use it to compare the safety of vehicles before a purchase, a fleet decision or an insurance review. Covers US passenger vehicles rated in the federal New Car Assessment Program. rated is false when the model year has no rated variant or none matches variant; a rating is null when the source says the test was not run. To start from a vehicle identification number, decode it first with Vehicle Identification. Recalls and owner complaints have their own tools.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
integer
required
The model year. At least 1990. Model year cannot be later than next year.
string
required
The vehicle make, for example Toyota. 2 to 40 characters.
string
required
The vehicle model, for example Camry. 1 to 60 characters.
string
Text found in the variant description, matched without regard to case, for example AWD or 4 DR. Without it the first rated variant is used. 1 to 40 characters.
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_crash_ratingsobject
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.
object[]
Every rated variant of the model year, in the order the source lists them.
number
The identifier the source gives this rated variant.
string
The variant as the source describes it, for example 2024 Toyota CAMRY 4 DR FWD.
boolean
True when a variant was rated and the fields below describe it.
number
The identifier of the rated variant.
null when the source gives no value.string
The rated variant as the source describes it.
null when the source gives no value.integer
Overall stars, 1 to 5.
null when the source gives no value.integer
Frontal crash stars, 1 to 5.
null when the source gives no value.integer
Frontal crash stars for the driver, 1 to 5.
null when the source gives no value.integer
Frontal crash stars for the front passenger, 1 to 5.
null when the source gives no value.integer
Side crash stars, 1 to 5.
null when the source gives no value.integer
Side barrier crash stars for the driver, 1 to 5.
null when the source gives no value.integer
Side barrier crash stars for the rear passenger, 1 to 5.
null when the source gives no value.integer
Side pole crash stars, 1 to 5.
null when the source gives no value.integer
Rollover resistance stars, 1 to 5.
null when the source gives no value.number
The chance of rollover in a single-vehicle crash, as a fraction (0.099 is 9.9 percent).
null when the source gives no value.string
The outcome of the dynamic rollover test, for example No Tip.
null when the source gives no value.string
Whether electronic stability control is fitted: Standard, Optional or No.
null when the source gives no value.string
Whether forward collision warning is fitted: Standard, Optional or No.
null when the source gives no value.string
Whether lane departure warning is fitted: Standard, Optional or No.
null when the source gives no value.number
How many owner complaints the source attaches to the variant.
null when the source gives no value.number
How many recalls the source attaches to the variant.
null when the source gives no value.number
How many investigations the source attaches to the variant.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-crash-ratings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"model_year": 2024,
"make": "Toyota",
"model": "Camry",
"variant": "FWD"
}),
});
const result = await agent.tool('lookup/vehicle-crash-ratings', {
model_year: 2024,
make: 'Toyota',
model: 'Camry',
variant: 'FWD'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_crash_ratings",
"result": {
"variants": [
{
"vehicle_id": 19427,
"description": "2024 Toyota CAMRY 4 DR AWD"
},
{
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD"
}
],
"rated": true,
"vehicle_id": 19426,
"description": "2024 Toyota CAMRY 4 DR FWD",
"overall_rating": 5,
"front_crash_rating": 5,
"front_driver_rating": 5,
"front_passenger_rating": 5,
"side_crash_rating": 5,
"side_driver_rating": 5,
"side_passenger_rating": 5,
"side_pole_rating": 5,
"rollover_rating": 5,
"rollover_risk": 0.099,
"tip_result": "No Tip",
"electronic_stability_control": "Standard",
"forward_collision_warning": "Standard",
"lane_departure_warning": "Standard",
"complaints_count": 51,
"recalls_count": 1,
"investigations_count": 0
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}