Skip to main content

vetting

Risk & Vetting Filters

These filters can be combined and used to ensure search results meet a minimum threshold of safety, risk, and/or compliance.

Filter FieldValue / Resulting Behavior
hide_oos
0Any
1Exclude any Out-of-Service companies
carrier_authThis filter allows you to filter results based on Current Interstate Operating Authority Status. A Company's Current Interstate Operating Authority Status can change daily.
0Any
1Has Active Authority
2Does Not Have Active Authority
3Applied For Authority
carrier_risk_min
carrier_risk_max
If both min & max are set, then results will be filtered by the company's calculated Risk Radar level. Only carriers whose risk radar level falls within the specified range will be returned.

For this filter, the values and risk levels are:
1Low Risk
2Elevated Risk
3High Risk
4Disqualified
carrier_safety_flagsFilters results based on the Safety Rating, as rated by the FMCSA. This is a bitflags filter; provide a single number made up from the values below. Each bit corresponds to a different possible safety rating:

Possible Values are:
1Not Rated
2Rated Satisfactory
4Rated Conditional
8Rated Unconditional
For example, to show only Not Rated (1) and Rated Satisfactory (2) companies, use the filter "carrier_safety_flags":3, since 1+2=3.
carrier_basic_unsafe_max0-100 : The maximum allowed percentage for the Unsafe Driving SMS Percentile.

Higher percentiles in a given SMS category indicate that a company has shown worse performance relative to other companies in their peer group.
carrier_basic_hos_max0-100 : The maximum allowed percentage for the Hours of Service SMS Percentile.

Higher percentiles in a given SMS category indicate that a company has shown worse performance relative to other companies in their peer group.
carrier_basic_vehicle_max0-100 : The maximum allowed percentage for the Vehicle Maintenance SMS Percentile.

Higher percentiles in a given SMS category indicate that a company has shown worse performance relative to other companies in their peer group.
carrier_basic_alcohol_max0-100 : The maximum allowed percentage for the Drugs & Alcohol SMS Percentile.

Higher percentiles in a given SMS category indicate that a company has shown worse performance relative to other companies in their peer group.
carrier_basic_fitness_max0-100 : The maximum allowed percentage for the Driver Fitness SMS Percentile.

Higher percentiles in a given SMS category indicate that a company has shown worse performance relative to other companies in their peer group.

Examples

SMS Percentiles Filter

Show company's that are below 65% in any given SMS percentile category:

{
"filters":{
"carrier_basic_unsafe_max":65,
"carrier_basic_hos_max":65,
"carrier_basic_vehicle_max":65,
"carrier_basic_alcohol_max":65,
"carrier_basic_fitness_max":65
}
}

Active Authority, not Rated Conditional or Unsatisfactory

Show only results that are currently active and are not rated Conditional/Unsatisfactory by the FMCSA, and not Out of Service:

{
"filters":{
"carrier_safety_flags":3,
"carrier_auth":1,
"hide_oos":1
}
}