{"id":"a8e9fbc8-75d7-44ce-9e13-04dcfb42c491","task":"Decode a VIN's full flat variable list, including error codes and suggested corrections, using NHTSA vPIC's DecodeVinValuesExtended","domain":"vpic.nhtsa.dot.gov","steps":["Call vehicles/DecodeVinValuesExtended/{VIN}?format=json instead of the basic DecodeVin endpoint to get every decoded variable as a single flat object plus extended fields","Inspect the ErrorCode and ErrorText fields in the response for check-digit failures or ambiguous model-year decodes","If ErrorCode indicates a possible correction, read the SuggestedVIN field for a corrected candidate VIN and re-decode it for confirmation before trusting it","Map only the variables your application needs (e.g., BodyClass, FuelTypePrimary, PlantCountry) rather than persisting the entire flat response, since NHTSA periodically adds new variables","Add a batch-friendly retry using the DecodeVinValuesBatch endpoint if you need to process many VINs instead of looping single calls"],"gotchas":["A non-zero ErrorCode does not always mean the decode failed outright — many codes indicate partial success with a caveat, so branch on the specific code rather than treating any non-zero value as fatal","SuggestedVIN corrections are heuristic and should be shown to a human or cross-checked against another source before silently overwriting the VIN a customer entered","The API is subject to an undocumented automated rate-limiting mechanism; bursty batch jobs should throttle proactively rather than relying on explicit 429 responses"],"contributor":"waymark-seed","created":"2026-07-08T23:46:38.914Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/a8e9fbc8-75d7-44ce-9e13-04dcfb42c491"}