{"uid":"cap_KvgNumIgN-aqb2VlnttpL","slug":"oneshot-agent-api-vin-lookup-vehicle-identification-5d30d082","name":"OneShot Agent API – VIN Lookup / Vehicle Identification","description":"Decode a vehicle identification number into make, model, year and build details.","url":"https://win.oneshotagent.com/v1/tools/lookup/vehicle-identification?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vin":{"type":"string","description":"The vehicle identification number. A VIN is 17 characters: digits and capital letters, never I, O or Q."},"model_year":{"type":"integer","description":"Model year, when known. Resolves the year for numbers where position 10 is ambiguous. From 1981 to 2100."}}},"responseSchema":{"type":"json","example":{"vin":"1HGCM82633A004352","make":"HONDA","trim":"EX-V6","doors":2,"model":"Accord","notes":[],"series":null,"decoded":true,"fuel_type":"Gasoline","body_class":"Coupe","drive_type":null,"model_year":2003,"plant_city":"MARYSVILLE","plant_state":"OHIO","manufacturer":"AMERICAN HONDA MOTOR CO., INC.","transmission":"Automatic","vehicle_type":"PASSENGER CAR","plant_country":"UNITED STATES (USA)","suggested_vin":null,"engine_cylinders":6,"check_digit_valid":true,"engine_horsepower":240,"engine_displacement_l":3,"gross_vehicle_weight_rating":"Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Soj51MnWEnBegB505MKUD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes a 17-character VIN into full vehicle specification details including make, model, trim, body class, engine, and plant information","exampleAgentPrompt":"Can you decode the VIN 1HGCM82633A004352 and tell me the make, model, trim, engine specs, and where it was manufactured?","exampleUseCases":[{"title":"Used car purchase verification","prompt":"I'm looking at buying a used 2003 Honda Accord with VIN 1HGCM82633A004352 — can you decode that VIN and tell me the full spec, including trim, engine, transmission, and where it was built?"},{"title":"Insurance policy vehicle lookup","prompt":"I need to confirm the specs for a vehicle with VIN 5YJSA1DG9DFP14705 — can you pull the make, model, body class, fuel type, and GVWR from that VIN?"},{"title":"Fleet inventory identification","prompt":"We have a vehicle in our fleet with VIN 1FTFW1ET5DFC10312 and I'm not sure of the exact model year — can you decode it and give me the full details including year, trim, drivetrain, and engine horsepower?"}],"resultDescription":"Returns a JSON object with fully decoded vehicle information including VIN, make, model, trim, series, body class, doors, fuel type, drive type, transmission, engine cylinders, engine horsepower, engine displacement in liters, vehicle type, manufacturer name, plant city/state/country, model year, GVWR rating, check digit validity, decoded flag, notes, and a suggested VIN if the original had issues.","failureModes":["Invalid or malformed VIN (not 17 characters) returns decoded=false","Ambiguous model year in position 10 may require model_year parameter to resolve correctly","Unknown or unrecognized VIN may return partial data with decoded=false","Payment failure over x402 if insufficient USDC balance","Network timeout or service unavailability"],"whenToPreferThis":"Choose this endpoint when you need to decode a raw VIN string into structured vehicle metadata — particularly make, model, trim, engine, and manufacturing details — without needing to pass through a DMV or registry. It is ideal for automotive research, fleet management, insurance verification, or any workflow where a VIN is the only known identifier and full vehicle specs are needed. At $0.005 per call with no API key required, it is well-suited for high-volume or ad-hoc agent workflows using x402 micropayments on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:37:21.365Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-vin-lookup-vehicle-identification-5d30d082"}