Data Dictionary

USDOT number — the primary identifier for every motor carrier.

Docket type prefix (MC, MX, or FF).

Numeric portion of the docket.

Full docket string (prefix + number).

CarrierOk profile ID (DOT-docket). Used as the key for monitoring endpoints.

Employer Identification Number (IRS tax ID).

Legal business name as registered with FMCSA.

Whether the legal_name is a DBA (Doing Business As).

Entity type: Carrier, Broker, or Freight Forwarder.

Interstate or intrastate operation scope.

Business organization type (Corporation, LLC, etc.).

Current USDOT registration status.

Legacy ICC docket numbers associated with this carrier.

Date the carrier was first registered with FMCSA (YYYY-MM-DD).

Days since FMCSA registration. Used to identify new entrants (< 540 days).

Date of the most recent data snapshot from FMCSA.

Common (for-hire) authority status: Active, Inactive, or None.

Contract authority status.

Broker authority status.

Whether common authority application is pending.

Whether contract authority application is pending.

Whether broker authority application is pending.

Whether common authority is under FMCSA review.

Whether contract authority is under FMCSA review.

Whether broker authority is under FMCSA review.

Whether common authority is currently revoked.

Whether contract authority is currently revoked.

Whether broker authority is currently revoked.

Days since common authority was first granted.

Days common authority has been continuously active.

Days since contract authority was first granted.

Days contract authority has been continuously active.

Date common authority was first granted (YYYY-MM-DD).

Date contract authority was first granted (YYYY-MM-DD).

Total number of authority revocations in carrier history.

Days since the most recent authority revocation.

Date of the most recent common authority revocation.

Date of the most recent revocation of any authority type.

True if at least one authority type is active.

Historical authority status changes with dates.

BIPD liability coverage currently on file (dollars).

BIPD coverage required for this carrier's authority type.

Cargo insurance currently on file (dollars).

Cargo insurance required by FMCSA.

Surety bond/trust fund currently on file (dollars).

Surety bond amount required.

True if all required insurance coverage is on file.

Historical insurance policy changes.

Total number of insurance policy cancellations.

Date of the most recent insurance cancellation.

Inspection Selection System score (1–100). Higher = higher inspection priority.

CarrierOk ISS-based recommendation: PASS, REVIEW, or FAIL.

Explanation for the ISS recommendation.

CarrierOk composite risk classification: Low, Medium, High, or Very High.

Probability value underlying the risk_score classification (0–1).

CarrierOk safety composite score (0–100).

FMCSA safety rating: Satisfactory, Conditional, Unsatisfactory, or Not Rated.

Date the safety rating was assigned.

Type of the most recent FMCSA review.

Date of the most recent FMCSA review.

True when the carrier MEETS safe-carrier criteria: has roadside inspections on record, no active BASIC alerts, not Conditional/Unsatisfactory rated, and out-of-service rates below thresholds. This is a positive signal (true = safe), not a risk flag, and not FMCSA's official High Risk Carrier designation. Null for intrastate carriers.

Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.

BASIC percentile (0–1) relative to peer group. Higher = worse. Available for crash_indicator and hazardous_materials (CarrierOk-computed), plus 5 FMCSA-public categories.

True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.

True if a roadside alert (elevated risk) is active.

True if an acute/critical violation indicator exists.

FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).

Historical BASIC percentile trends over time.

Total violation count across all categories.

Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.

Severe violations (higher weight in BASIC calculation).

Violations that resulted in an out-of-service order.

Date of the most recent violation (YYYY-MM-DD).

Total inspections across all types.

Driver-focused inspections.

Vehicle-focused inspections.

Hazmat-focused inspections.

Driver inspections resulting in an OOS order.

Vehicle inspections resulting in an OOS order.

Hazmat inspections resulting in an OOS order.

Vehicle OOS rate as a decimal (e.g., 0.24 = 24%).

Driver OOS rate as a decimal.

Hazmat OOS rate as a decimal.

National average vehicle OOS rate for comparison.

National average driver OOS rate.

National average hazmat OOS rate.

True if driver OOS rate significantly exceeds national average.

True if vehicle OOS rate significantly exceeds national average.

True if hazmat OOS rate significantly exceeds national average.

Number of distinct states where this carrier has been inspected.

Number of distinct power units inspected.

Number of distinct trailers inspected.

Date of the most recent inspection.

Historical inspection detail records.

Total reportable crashes.

Total fatalities from crashes.

Total injuries from crashes.

Total tow-away crashes.

Date of the most recent crash (YYYY-MM-DD).

Individual crash records with details.

Crash summary aggregated by time period.

Total power units (trucks + tractors). The industry-standard fleet size metric.

Total drivers reported on MCS-150.

Total drivers holding a CDL.

Company-owned tractors.

Term-leased tractors.

Company-owned trailers.

Term-leased trailers.

Total trailers (owned + leased).

Total trucks (typically equals total_power_units).

Total buses.

Drivers operating in interstate commerce.

Interstate drivers within 100-mile radius.

Interstate drivers beyond 100-mile radius.

Drivers operating in intrastate commerce.

Intrastate drivers within 100-mile radius.

Intrastate drivers beyond 100-mile radius.

Average trip-leased drivers.

Primary phone number (digits only).

Fax number.

Cell phone number.

Primary email address.

Email domain (extracted from email_address).

Primary company officer or contact person.

Secondary contact person.

Full physical address string.

Street address.

City.

Two-letter state code.

ZIP code.

ISO country code.

True if the physical address is flagged as undeliverable.

Full mailing address string.

Mailing street address.

Mailing city.

Mailing state.

Mailing ZIP code.

Mailing ISO country code.

True if the mailing address is flagged as undeliverable.

Address on file with authority registration.

Authority registration street.

Authority registration city.

Authority registration state.

Authority registration ZIP.

Phone on file with authority registration.

Fax on file with authority registration.

True if authority registration address is undeliverable.

Unique hash ID for the physical address (used in network graph).

Unique hash ID for the mailing address.

Unique hash ID for the authority registration address.

All address hash IDs associated with this carrier.

Primary cargo description.

Authorized for general freight.

Authorized for household goods.

Authorized for metal sheets, coils, rolls.

Authorized for motor vehicles.

Authorized for driveaway/towaway.

Authorized for logs, poles, beams, lumber.

Authorized for building materials.

Authorized for mobile homes.

Authorized for machinery and large objects.

Authorized for fresh produce.

Authorized for liquids and gases.

Authorized for intermodal containers.

Authorized for passengers.

Authorized for oilfield equipment.

Authorized for livestock.

Authorized for grain, feed, hay.

Authorized for coal, coke.

Authorized for meat.

Authorized for garbage, refuse, trash.

Authorized for chemicals.

Authorized for US mail.

Authorized for dry bulk commodities.

Authorized for refrigerated foods.

Authorized for beverages.

Authorized for paper products.

Authorized for utilities.

Authorized for farm supplies.

Authorized for construction.

Authorized for water well.

Authorized for other/miscellaneous cargo.

Primary operation classification.

Authorized for-hire carrier.

Exempt for-hire carrier.

Private (property) carrier.

Private passenger (business).

Private passenger (non-business).

Migrant carrier.

US Mail carrier.

Federal government carrier.

State government carrier.

Local government carrier.

Indian nation carrier.

Date of the most recent MCS-150 biennial update (YYYY-MM-DD).

Year of the most recent MCS-150 update.

Annual mileage reported on MCS-150.

Type of the last MCS-151 review.

Date of the last MCS-151 review.

Year of the last MCS-151 review.

Process agent company name.

Process agent attention/contact.

Process agent street address.

Process agent city (note: field name has typo in API).

Process agent state.

Process agent ZIP code.

Process agent country code.

Full change history for all contact fields. Each entry has key (field name), value, start_date, end_date, current_flag.

Number of legal name changes.

Date of the most recent name change.

Number of email address changes.

Date of the most recent email change.

Number of phone number changes.

Date of the most recent phone change.

Number of address changes.

Date of the most recent address change.

Number of contact person changes.

Date of the most recent contact person change.

True if address history contains notable patterns.

True if this carrier shares contact data with other entities.

True if this carrier shares equipment with other entities.

Entities sharing this physical address.

Details of entities sharing this physical address.

Entities sharing this mailing address.

Details of entities sharing this mailing address.

Entities sharing this phone number.

Details of entities sharing this phone.

Entities sharing this cell number.

Details of entities sharing this cell number.

Entities sharing this fax number.

Details of entities sharing this fax.

Entities sharing this email.

Details of entities sharing this email.

Entities sharing this EIN.

Details of entities sharing this EIN.

Entities sharing this DUNS number.

Details of entities sharing this DUNS.

Distinct equipment units shared with other carriers.

Equipment shared with other entities.

Extended equipment network data.

Power units shared with other carriers.

Trailers shared with other carriers.

Total shared power units.

Total shared trailers.

Total loads observed.

Less-than-truckload shipments.

LTL percentage of total loads.

Full-truckload shipments.

FTL percentage of total loads.

Empty (deadhead) moves observed.

Deadhead rate as a decimal.

Date of the earliest observed load.

Date of the most recent observed load.

Load aggregates by time period or lane.

Frequently used origin/destination corridors.

JSON summary of fleet equipment by make, model, year, and type.

Historical equipment changes.

True if any benchmark anomaly is detected.

Observed inspection-to-mileage ratio.

Expected lower bound for inspection-to-mileage ratio.

Expected upper bound for inspection-to-mileage ratio.

True if inspection-to-mileage ratio is outside expected range.

Observed inspected-power-units ratio.

Expected lower bound for inspected-power-units ratio.

Expected upper bound for inspected-power-units ratio.

True if inspected-power-units ratio is outside expected range.

Observed power-unit-to-mileage ratio.

Expected lower bound for power-unit-to-mileage ratio.

Expected upper bound for power-unit-to-mileage ratio.

True if power-unit-to-mileage ratio is outside expected range.

Private carrier (not for-hire).

Enterprise/large fleet carrier.

Household goods mover.

Passenger carrier.

Property carrier.

Authorized for hazardous materials.

Currently under an out-of-service order.

EPA SmartWay partner.

CARB TRU compliant (California).

PHMSA (Pipeline and Hazardous Materials Safety Administration) registered.

Risk factor scores for a specific load. Only populated when event details are submitted via POST request body.

Geographic data points associated with the carrier.