{"uid":"cap_VzVrm5kdl9pCkbGkWtpLe","slug":"api-acre-vin-decode-cadc31e0","name":"API Acre VIN Decode","description":"Decode a full 17-character VIN into normalized NHTSA vPIC make, model, year, body, engine, transmission, plant, fuel, and occupancy fields with official source evidence and explicit missing-data semantics.","url":"https://apiacre.com/v1/data/vin-decode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vin":{"type":"string"},"model_year":{"anyOf":[{"type":"integer"},{"type":"null"}]}}},"responseSchema":{"type":"json","example":{"data":{"vin":"1HGCM82633A004352","decode":{"clean":true,"status":"clean","errorText":"0 - VIN decoded clean. Check Digit (9th position) is correct","apiMessage":"Results returned successfully. NOTE: Any missing decoded values should be int...","errorCodes":[0]},"source":{"dataset":"vPIC","provider":"National Highway Traffic Safety Administration","attribution":"NHTSA Product Information Catalog and Vehicle Listing (vPIC).","endpointUrl":"https://vpic.nhtsa.dot.gov/api/vehicles/DecodeVinValuesExtended/1HGCM82633A00...","documentationUrl":"https://vpic.nhtsa.dot.gov/api/"},"vehicle":{"make":"HONDA","model":"Accord","modelYear":2003,"manufacturer":"AMERICAN HONDA MOTOR CO., INC.","manufacturerId":988},"limitations":["Missing decoded values mean NHTSA has no data for that variable, not that a f...","A decode does not establish ownership, title, registration, accident, theft, ...","VINs can be linkable vehicle identifiers; do not use this result to identify ..."],"retrievedAt":"2026-08-12T01:30:00+00:00","missingFields":["series","driveType","fuelTypeSecondary","electrificationLevel","engine.manufacturer","plant.companyName","occupancy.seats","occupancy.seatRows"],"modelYearHint":2003,"decodedFieldCount":20},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[]},"service":"data.vin-decode","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TvzRshiEer2rbFg7oNlxc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes a full 17-character VIN into normalized NHTSA vPIC vehicle fields including make, model, year, body, engine, transmission, plant, fuel, and occupancy with source attribution and explicit missing-data semantics.","exampleAgentPrompt":"Can you decode the VIN 1HGCM82633A004352 and tell me the make, model, year, engine specs, and transmission type?","exampleUseCases":[{"title":"Pre-purchase vehicle inspection check","prompt":"I'm thinking of buying a used car and the seller gave me the VIN 2T1BURHE0JC025512 — can you decode it and tell me the make, model, year, body style, engine, and where it was manufactured?"},{"title":"Insurance quoting data enrichment","prompt":"I need to fill out an insurance form but only have the VIN 3VWFE21C04M000001 — can you pull the full vehicle details from NHTSA including fuel type, number of cylinders, and gross vehicle weight rating?"},{"title":"Fleet management vehicle cataloging","prompt":"We're cataloging our fleet and I need to decode the VIN JN1AZ4EH7FM730309 to get the official make, model, trim, transmission style and speeds, and manufacturing plant city and country."}],"resultDescription":"Returns a structured JSON object with the decoded vehicle's make, model, trim, model year, body class, vehicle type, engine details (cylinders, horsepower, displacement, model), transmission (style and speeds), plant location (city, state, country), fuel types (primary and secondary), occupancy and weight rating, manufacturer name and ID, electrification level, decode status/clean flag, error codes, NHTSA source attribution including the original vPIC endpoint URL, and a list of data limitations and caveats. Missing fields are explicitly null rather than omitted.","failureModes":["Invalid or malformed VIN (not 17 characters or invalid characters) returns a decode error with NHTSA error codes","VIN check digit mismatch flagged in the decode status and errorText","NHTSA has no data for the specific VIN or vehicle variable — returned as null with a clear apiMessage caveat","NHTSA rate limiting may affect upstream data freshness, though API Acre caches results","Fictional or test VINs may partially decode but return many null fields"],"whenToPreferThis":"Choose this endpoint when you need authoritative, normalized vehicle specification data from the official NHTSA vPIC database for a known 17-character VIN. It is ideal when you need explicit null semantics for missing fields (distinguishing 'no data' from 'feature absent'), NHTSA source attribution, and structured engine/transmission/plant detail in a single call. Prefer it over generic VIN lookup services when regulatory-grade provenance or normalized field names matter, such as for insurance, fleet management, or compliance workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:44:09.925Z","isFirstParty":false,"canonicalSlug":"api-acre-vin-decode-cadc31e0"}