What you can ask
- “What does FMCSA have for the area or asset I'm working on?”
- “Pull the most recent FMCSA records and put them in a table.”
- “What does FMCSA cover, and how fresh is the data?”
About this source
FMCSA carrier safety, crash, and inspection records for vetting third-party haulers. No user credentials: PatchOps supplies QCMobile's required WebKey; DOT Socrata reads are keyless. CARRIER: getCarrierByDOT, searchCarriersByName, getCarrierByDocket. SAFETY: getCarrierBasics (BASIC scores), getCarrierAuthority (authority + insurance), getCarrierOOS. HISTORY: getCrashes (all-time), getInspections (rolling ~3yr). RULES: 1. DOT number is primary; resolve it with searchCarriersByName. 2. Subsidiaries can have different DOT numbers; name search returns up to 20 matches. 3. Crashes are all-time; inspections cover ~3 years. Zero rows is valid. 4. BASIC scores can be stale (runDate surfaced) — don't read percentiles as current.
Connector ID fmcsa
Provenance
Freshness & coverage
Caveats
- ⚠ QCMobile requires a WebKey on every upstream request; PatchOps supplies a platform-managed FMCSA_WEBKEY, so users do not provide credentials.
- ⚠ Crash and inspection detail comes from keyless DOT Socrata datasets at data.transportation.gov.
› Methods (8)
Technical detail for developers: parameters, pagination, units, and freshness per method.
getCarrierByDOT
readCarrier snapshot: status, crash totals, OOS rates, insurance.
Required paramsdotNumbersearchCarriersByName
readFind carriers by name. Returns DOT numbers + key safety stats.
Required paramsnamegetCarrierByDocket
readLook up a carrier by MC/docket number.
Required paramsdocketNumbergetCarrierBasics
readSMS BASIC safety scores by category. Can be stale (runDate).
Required paramsdotNumbergetCarrierAuthority
readOperating authority status + insurance on file.
Required paramsdotNumbergetCarrierOOS
readCurrent out-of-service orders for the carrier.
Required paramsdotNumbergetCrashes
readCrash records (all-time) (FMCSA). Filter by date range and state.
Required paramsdotNumbergetInspections
readRoadside inspections (rolling ~3yr). Filter by date and state.
Required paramsdotNumber
