curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"vin": "1HGCM82633A004352"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"vin": "1HGCM82633A004352"
}),
});
const result = await agent.tool('lookup/vehicle-identification', {
vin: '1HGCM82633A004352'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_identification",
"result": {
"vin": "1HGCM82633A004352",
"decoded": true,
"check_digit_valid": true,
"make": "HONDA",
"model": "Accord",
"model_year": 2003,
"trim": "EX-V6",
"series": null,
"body_class": "Coupe",
"vehicle_type": "PASSENGER CAR",
"doors": 2,
"drive_type": null,
"engine_cylinders": 6,
"engine_displacement_l": 3,
"engine_horsepower": 240,
"fuel_type": "Gasoline",
"transmission": "Automatic",
"gross_vehicle_weight_rating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
"plant_city": "MARYSVILLE",
"plant_state": "OHIO",
"plant_country": "UNITED STATES (USA)",
"suggested_vin": null,
"notes": []
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Vehicle Identification
Decode a vehicle identification number into make, model, year and build details.
POST
/
v1
/
tools
/
lookup
/
vehicle-identification
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"vin": "1HGCM82633A004352"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"vin": "1HGCM82633A004352"
}),
});
const result = await agent.tool('lookup/vehicle-identification', {
vin: '1HGCM82633A004352'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_identification",
"result": {
"vin": "1HGCM82633A004352",
"decoded": true,
"check_digit_valid": true,
"make": "HONDA",
"model": "Accord",
"model_year": 2003,
"trim": "EX-V6",
"series": null,
"body_class": "Coupe",
"vehicle_type": "PASSENGER CAR",
"doors": 2,
"drive_type": null,
"engine_cylinders": 6,
"engine_displacement_l": 3,
"engine_horsepower": 240,
"fuel_type": "Gasoline",
"transmission": "Automatic",
"gross_vehicle_weight_rating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
"plant_city": "MARYSVILLE",
"plant_state": "OHIO",
"plant_country": "UNITED STATES (USA)",
"suggested_vin": null,
"notes": []
},
"evidence": {
"source": "US National Highway Traffic Safety Administration",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Decode a 17-character vehicle identification number (VIN) into the vehicle it names: make, model, model year, trim, body class, engine, fuel, transmission, manufacturer and assembly plant. Use it to confirm that a vehicle in a listing, title, claim or invoice is what it says it is. Covers vehicles sold in the United States.
decoded is false when the number does not resolve to a vehicle; notes then says why.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The 17-character vehicle identification number. A VIN is 17 characters: digits and capital letters, never I, O or Q.
integer
Model year, when known. Resolves the year for numbers where position 10 is ambiguous. From 1981 to 2100.
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_identificationobject
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
Vin.
boolean
True when the number resolved to a make and model year.
boolean
True when position 9 matches the checksum of the other characters.
string
Make.
null when the source gives no value.string
Model.
null when the source gives no value.number
Model year.
null when the source gives no value.string
Trim.
null when the source gives no value.string
Series.
null when the source gives no value.string
Body class.
null when the source gives no value.string
Vehicle type.
null when the source gives no value.number
Doors.
null when the source gives no value.string
Drive type.
null when the source gives no value.number
Engine cylinders.
null when the source gives no value.number
Engine displacement l.
null when the source gives no value.number
Engine horsepower.
null when the source gives no value.string
Fuel type.
null when the source gives no value.string
Transmission.
null when the source gives no value.string
Gross vehicle weight rating.
null when the source gives no value.string
Manufacturer.
null when the source gives no value.string
Plant city.
null when the source gives no value.string
Plant state.
null when the source gives no value.string
Plant country.
null when the source gives no value.string
A corrected number, when the decoder could infer one.
null when the source gives no value.string[]
Decoder messages: what was wrong with the number, if anything.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"vin": "1HGCM82633A004352"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"vin": "1HGCM82633A004352"
}),
});
const result = await agent.tool('lookup/vehicle-identification', {
vin: '1HGCM82633A004352'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "vehicle_identification",
"result": {
"vin": "1HGCM82633A004352",
"decoded": true,
"check_digit_valid": true,
"make": "HONDA",
"model": "Accord",
"model_year": 2003,
"trim": "EX-V6",
"series": null,
"body_class": "Coupe",
"vehicle_type": "PASSENGER CAR",
"doors": 2,
"drive_type": null,
"engine_cylinders": 6,
"engine_displacement_l": 3,
"engine_horsepower": 240,
"fuel_type": "Gasoline",
"transmission": "Automatic",
"gross_vehicle_weight_rating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
"plant_city": "MARYSVILLE",
"plant_state": "OHIO",
"plant_country": "UNITED STATES (USA)",
"suggested_vin": null,
"notes": []
},
"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}