Corrections & Error Reporting

How to report an error

The TruckCodex display reflects the upstream record. If a USDOT, VIN, recall, inspection, or insurance row is wrong, the canonical fix is at the publisher:

• Carrier registry, authority, insurance, BOC-3, OOS → FMCSA Licensing & Insurance: li-public.fmcsa.dot.gov + carrier MCS-150 update.
• Inspections, crashes, complaints → FMCSA DataQs: dataqs.fmcsa.dot.gov.
• Recalls, TSBs, investigations, vehicle complaints → NHTSA: nhtsa.gov/contact.
• EIA diesel prices → eia.gov/about/contact.
• IFTA tax rates → iftach.org.

While that is in flight, also email us at [email protected] with the page URL and the field in question. We will flag the record so future imports do not silently overwrite an in-progress correction, and so we can prioritize re-pulling the source once the publisher confirms the fix.

What we will and will not fix

We will fix:

• Display bugs (mislabeled fields, wrong formatting, broken layout).
• Broken links to upstream sources.
• Stale cross-joins (e.g., a chameleon cluster computed before a USDOT change propagated).
• Mistakes in our editorial copy (knowledge-base articles, explainers, FAQs).

We will not modify:

• Upstream data values. If FMCSA says a carrier had a violation, we do not unilaterally remove or rewrite it. The correction must flow through DataQs first; we then re-import.
• The historical timeline. Authority transitions, prior addresses, prior insurers, prior officers retained even after the upstream record changes — this is the never-delete doctrine and it is core to the product.

Heuristic disclaimers

Two TruckCodex features compute derived signals from public records: the chameleon detector (USDOT inactive → reactive at same address/officer) and insurance-watch (carriers near insurance lapse). Both are heuristics, not legal determinations. They surface patterns that public data already supports — nothing more.

If you believe a heuristic-derived label about your business is incorrect:

• The canonical correction path is still upstream. If FMCSA L&I updates the underlying record (address, officer, authority status, insurance filing), the heuristic recomputes on the next import and the label changes accordingly.
• Email [email protected] with the page URL. If the upstream record is correct and our heuristic is misfiring, that is a bug we will fix in the algorithm.

Data removal

As a rule we do not remove entities from the surface. The never-delete doctrine exists because the historical record is the value — an authority that lapsed in 2019 is still relevant when the same officer reappears under a new USDOT in 2026.

For legal-hold or court-order scenarios we may suppress a page from search-engine indexing (<meta name="robots" content="noindex">) while leaving the underlying record in place. Outright deletion happens only when the upstream publisher itself withdraws the record and we re-import the absence.