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 Field | Value / Resulting Behavior | ||||||||
hide_oos |
| ||||||||
carrier_auth | This filter allows you to filter results based on Current Interstate Operating Authority Status. A Company's Current Interstate Operating Authority Status can change daily.
| ||||||||
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:
| ||||||||
carrier_safety_flags | Filters 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:
| ||||||||
carrier_basic_unsafe_max | 0-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_max | 0-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_max | 0-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_max | 0-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_max | 0-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
}
}