overview

Carrier Data

About Carrier Profiles

This is the data that is always present with any Carrier returned by our API. Carrier info is mostly FMCSA data, but may vary slightly due to our data sanitization techniques, post-processing, and if we were able to source the info via web scraping.

Cacheing Carrier Data

If your application will be cacheing Carrier data, be aware that we continuously update carriers with new available information. The authority and risk_radar fields can change daily; and the other fields can change monthly.

Carrier Object

Carriers returned by this API will have the following types of data attached to them:

field	type	description
dot	string	The Company's USDOT Number. This is the number used by the FMCSA as a unique identifier when collecting and monitoring a carrier's information.
docket	string	The company's primary Interstate Operating Authority Docket# (Also called a MC#). (optional) Dockets are always prefixed by either "MC", "MX", or "FF"; and then followed by a series of digits.
docket2	string	The company's secondary Docket# (optional)
docket3	string	The company's tertiary Docket# (optional)
name	string	Company's Name
dba	string	Doing-Business-As Name (optional)
phy_*	string	Company's Physical Street Address. The full list of fields are: field desc phy_street Street Address (Line1) (optional) phy_street2 Street Address (Line2) (optional) phy_city City phy_state State or Region/Province phy_zip ZIP or Postal Code phy_nation Country
mail_*	string	Company's Mailing Address. The full list of fields are: field desc mail_street Street Address (Line1) (optional) mail_street2 Street Address (Line2) (optional) mail_city City mail_state State or Region/Province mail_zip ZIP or Postal Code mail_nation Country
is_hireable	boolean	If true, this field indicates that a company's Classification Flags are a hirable category, such as "Authorized For Hire" or "Exempt For Hire"
is_carrier	boolean	If true, this field indicates that the company registered with the FMCSA as a Carrier
is_broker	boolean	If true, this field indicates that the company registered with the FMCSA as a Broker
hazmat_indicator	boolean	True when the company indicated that they haul hazardous materials
segment_combination	boolean	True when 70%+ of the company's indicated fleet is constituted of Combination Trucks
segment_straight	boolean	True when 30%+ of the company's indicated fleet is constituted of Straight Trucks
total_power_units	number	The total number of Power Units for this company. (Straight Trucks + Combination Trucks + Coaches/Buses/Vans)
total_truck_tractors	number	The total number of Truck Tractors for this company
total_straight_trucks	number	The total number of Straight Trucks for this company
total_trailers	number	The total number of Trailers for this company
total_drivers	number	The total number of Drivers for this company
total_cdl_drivers	number	The total number of CDL-Certified Drivers for this company
date_added	date	Date this company was added to the FMCSA database
last_inspection_date	date	Date of this company's last known roadside inspection, if any. (optional)
email_address	string	Company's email address. (optional)
tel_num	string	Company's telephone number. (optional)
cell_num	string	Company's secondary or cell phone number. (optional)
fax_num	string	Company's fax number. (optional)
company_rep_1	string	Name of a company representative. (optional)
company_rep_2	string	Name of a secondary company representative. (optional)
cargo_list	array of strings	A readable list of cargo classifications
driver_oos_inspection_total	number	The amount of drivers that were found to be out of service on an inspection.
vehicle_oos_inspection_total	number	The amount of vehicles that were found to be out of service on an inspection.
unsafe_driving_percent	number	The SMS percentage of unsafe driving violations.
hours_of_service_driving_percent	number	The SMS percentage of hours of service violations.
driver_fitness_percent	number	The SMS percentage of driver fitness violations.
drugs_and_alcohol_percent	number	The SMS percentage of drug and alcohol violations.
vehicle_maintenance_percent	number	The SMS percentage of vehicle maintenance violations.
property_insurance	boolean	Indicates whether the company meets the minimum insurance coverage thresholds for interstate operating authority for property.
household_goods	number	Indicates whether the company meets the minimum insurance coverage thresholds for interstate operating authority for household goods.
driver_cdl	number	The number of CDL drivers reported by the company.
driver_tot	number	The number of total drivers reported by the company..
driver_interstate	object	Property Type Explantion lt100 number Number of interstate drivers that operate within 100 miles. gt100 number Number of interstate drivers that operate beyond 100 miles. num number Total Interstate Drivers
driver_intrastate	object	Property Type Explantion lt100 number Number of intrastate drivers that operate within 100 miles. gt100 number Number of intrastate drivers that operate beyond 100 miles. num number Total Intrastate Drivers
self_reported_miles	number	Self-reported combined mileage across all commercial vehicles in the company’s fleet.
tel_num_info	object	Property Type Explanation e164 string Phone Number in E.164 format (international standard). geo_desc string A short description of the phone number's geographical location. is_voip boolean Is this phone number a VOIP (Voice Over IP) line? timezone string Timezone the phone number is registered in.
cell_num_info	object	Property Type Explanation e164 string Phone Number in E.164 format (international standard). geo_desc string A short description of the phone number's geographical location. is_voip boolean Is this phone number a VOIP (Voice Over IP) line? timezone string Timezone the phone number is registered in.
previous_tel_num	object	Property Type Explanation value string Previous phone number listed with the FMCSA. ts string The date that this value was last changed with the FMCSA.
previous_cell_num	object	Property Type Explanation value string Previous phone number listed with the FMCSA. ts string The date that this value was last changed with the FMCSA.
previous_email_address	object	Property Type Explanation value string Previous email listed with the FMCSA. ts string The date that this value was last changed with the FMCSA.
previous_mail_address	object	Property Type Explanation value string Previous mailing address listed with the FMCSA. ts string The date that this value was last changed with the FMCSA.
previous_phy_address	object	Property Type Explanation value string Previous physical address listed with the FMCSA. ts string The date that this value was last changed with the FMCSA.
outside_agency_reported_miles	number	Miles reported by an outside agency.
transfer_from_docket1	object	Property Name Property Type name string ts Date city string st string dot string docket string
transfer_from_docket2	object	Property Name Property Type name string ts Date city string st string dot string docket string
transfer_from_docket3	object	Property Name Property Type name string ts Date city string st string dot string docket string
transfer_to_docket1	object	Property Name Property Type name string ts Date city string st string dot string docket string
transfer_to_docket2	object	Property Name Property Type name string ts Date city string st string dot string docket string
transfer_to_docket3	object	Property Name Property Type name string ts Date city string st string dot string docket string
operation_flags	number	Bitflag Value Key Translation 1 A Authorized 2 B Exempt 4 C Private Property 8 D Private Passenger Business 16 E Private Passenger Non-Business 32 F Migrant 64 G US Mail 128 H Federal Government 256 I State Governemnt 512 J Local Government 1024 K Tribal 2048 L Other
equip_category	array of strings	Equipment Values "Flatbed" "Van" "Intermodal" "Tanker" "Bulk" "Reefer" "Pneumatic" "Hotshot" "RGN" "Drop Deck" "Specialty Bulk" "Specialty Flatbed" "Power Only" "Passenger" "Livestock" "Straight Flat" "Straight Van" "Straight Reefer Van" "Sprinter" "Auto Hauler"