Web Services Interface

Contact Customer Service About Any Questions

Integration with Carrier411 using our web services interface is available only though major TMS software providers including McLeod Software, TMW Systems, WolfByte Software, Strategy Systems, MercuryGate and others. If your company developed its own proprietary software system, integration with Carrier411 using web services is not available. Carrier411 also offers a CSV File Download feature as an alternative to integration using web services.


If you have any questions or would like web services enabled for your account, please call (888) 411-9661 between 9:00 AM and 6:00 PM EST Monday through Friday.


The cost to use our Web Services Interface is an additional $99.00 per month and requires an active Carrier411 account. We reserve the right to allow access to our web services interface, and there is an approval process for customers that would like web services enabled for their account.


Documentation Last Updated June 1, 2013

Welcome to the developer documentation for the Carrier411 Web Services Interface. We suggest you also review our Best Practices Implementation Guide, which supplements this documentation. Please also refer to the Web Services Change Log for details.


Carrier411 web services provides direct access to our robust technology platform, providing the ability to enable and enhance your transportation management software. We innovate for you, so you can innovate your business by running queries on structured data in real time. Transportation management software providers including McLeod Software, TMW Systems, WolfByte Software, Strategy Systems, MercuryGate and others are already integrated with Carrier411. If your company uses one of these TMS software providers, please contact them to obtain the Carrier411 integration module for your software.


Web services are essentially just a way to send data to and receive data from other systems via standard XML interfaces, typically using the SOAP protocol. Using web services is similar to submitting an HTTP request from one server to another, except that data is in an XML format.


Benefits of Using Carrier411 Web Services

Web services provides integration capabilites with Carrier411 directly from your server and brokerage software, sort of behind the scenes, without interacting through our website. In simple terms, your server communicates with our server.


Using a series of functions described below, our web services provide the ability for your system to make live remote procedure calls directly to our database of over 753,000 companies, which includes up-to-date information for every carrier, broker and freight forwarder registered with the FMCSA. Whether you are adding a new carrier or loading an existing carrier, your brokerage software can request and retrieve instant information for any MC, FF or MX number, including the insurance, operating authority, safety ratings, CSA 2010 BASIC scores and census data needed to keep your software database up-to-date automatically.


When using your transportation management software system, information from Carrier411 can be retrieved, stored and displayed. As a result, business rules can be set in your software system to determine how the data affects what you do, such as preventing a carrier with no active authority or an unsatisfactory safety rating from being assigned a load. Again, this can be done automatically.


Web services also provides the ability for your software system to interact directly with your Carrier411 account, so you can add and remove carriers from your monitoring list, and get a complete list of changes for all the companies you monitor. If you monitor thousands of carriers, then you know how time-consuming the process of manually updating records in your software system can be. Consider the consequences if you overlook updating certain carriers. Without a doubt, real-time integration using our web services improves efficiency and makes all that tedious, painstaking work a thing of the past.


Web Services Change Log

Change Log Description
June 1, 2013 Added wsGetFGReports function to return information about FreightGuard reports that have been submitted and released for all companies monitored by your account.
March 6, 2012 Added wsGetAllOOS function to return information about all carriers monitored that have Out of Service (OOS) Orders issued by the FMCSA, which requires the carriers to cease all motor vehicle operations regardless of operating authority status.
December 27, 2010 Retired wsSafeStatDate and wsGetAllSafeStat functions. Returns FaultCode indicating function no longer available.
December 27, 2010 Added wsSMSDate function to check the date Safety Measurement System (SMS) data was last updated.
December 27, 2010 Added wsGetAllSMS function to return BASIC scores and SMS data for all companies monitored.
December 27, 2010 Updated the Best Practices Implementation Guide. Added section for Updating SMS Data. Removed information about updating SafeStat scores using wsSafeStatDate and wsGetAllSafeStat functions, which are no longer available.
December 27, 2010 Updated the wsGetCompany and wsGetInsAuth functions to include SMS data. Fields for SafeStat scores remain in both functions to ensure existing parsing code works properly, but all SafeStat scores now only return NULL values.
December 27, 2010 Updated the Structure Elements and Possible Values section of this document to include information about SMS data.

Developers can use our Web Services Interface Test page to become familiar with the data structures returned by our web services functions. We suggest you also review our Best-Practices Implementation Guide, which supplements this documentation. All web services functions must be called using a SOAP request, or a FaultCode will be returned indicating the function was not invoked as a web service.


Function Descriptions

Functions Description
wsLogin.cfc Initiates your web services session. Returns SessionUUID.
wsGetCompany.cfc Returns one-dimensional array with safety rating, SMS data, insurance, authority and census data for specific MC FF MX number.
wsGetInsAuth.cfc Returns two-dimensional array with safety rating, SMS data, insurance, authority and census data for all companies monitored by your account that were updated within the specified number of days.
wsSafetyDate.cfc Returns one-dimensional array with the date carrier safety ratings were last updated.
wsGetSafetyUpdates.cfc Returns two-dimensional array with carrier safety ratings for companies monitored by your account that were updated within two months of last safety rating update.
wsGetAllSafety.cfc Returns two-dimensional array with carrier safety ratings for all registered companies monitored by your account.
wsSMSDate.cfc Returns one-dimensional array with the date SMS data was last updated.
wsGetAllSMS.cfc Returns two-dimensional array with BASIC scores and SMS data for all companies monitored by your account.
wsStartMonitoring.cfc Adds registered company to your Carrier411 account.
wsStopMonitoring.cfc Deletes registered company from your Carrier411 account.
wsGetInsPols.cfc Returns two-dimensional array with insurance policy information for the specified MC FF MX number.
wsGet411Status.cfc Returns one-dimensional array to indicate whether MC FF MX number is monitored by your account.
wsGetDocketList.cfc Returns two-dimensional array with docket numbers and dates for all registered companies monitored by your account.
wsGetAllAuth.cfc Returns two-dimensional array with only insurance and authority data for companies monitored regardless of when information changed.
wsInsAuthDateTime.cfc Returns one-dimensional array with the date and time FMCSA insurance and authority updates were last processed.
wsGetAllOOS.cfc Returns two-dimensional array with safety rating, SMS data, insurance, authority and census data for all companies monitored by your account that have Out of Service (OOS) Orders issued by the FMCSA, requiring the carriers to cease all motor vehicle operations.
wsGetFGReports.cfc Returns two-dimensional array with information about FreightGuard reports that have been submitted and released for all companies monitored by your account.

wsLogin.cfc  (login)

This function emulates a member logging into the Carrier411 website. Login must be performed before any web services request can be made. The SessionUUID returned is required for all function calls and must be submitted with each subsequent web services request. Each request must also be submitted by the same IP address as the original login request.


The SessionUUID provides security and allows member-specific information to be used in functions calls. Once a web services session is established, that session is valid throughout the day until 12:00 AM (midnight) EST when it will timeout.


WSDL http://webservices.carrier411.com/wsLogin.cfc?wsdl
Method login
Signature string wsLogin.cfc( string param1, string param2 )
Purpose Initiates your web services session.
Errors

FaultCode 100: Login Failed. Not invoked as a web service.

FaultCode 101: Login failed. Invalid username or password.

FaultCode 102: Login failed. Account inactive.

FaultCode 103: Login failed. Account suspended.

FaultCode 104: Login failed. Trial accounts cannot use web services.

FaultCode 105: Login failed. Web services not activated for account.

FaultCode 106: Login failed. Requesting server IP address changed.

Parameters

string param1 -- Carrier411 username

string param2 -- Carrier411 password

Returned struct SessionUUID -- 35-character alpha-numeric SessionUUID if login authenticated. Otherwise, a FaultCode is returned.

Logic Model for Carrier411 Web Services Login Using wsLogin



How to Instantiate wsLogin Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsLogin.cfc?wsdl"
   method="login"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="yourusername" />
   <cfinvokeargument name="param2" value="yourpassword" />
</cfinvoke>

How to Instantiate wsLogin Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsLogin.cfc?wsdl',true);
$param1="yourusername"; //Carrier411 username
$param2="yourpassword"; //Carrier411 password
$params=array($param1,$param2);

$results=$client->call("login",$params);

wsGetCompany.cfc  (checkcompany)

This function enables you to retrieve information about a company by specifying their docket number. Provide the MC, FF or MX number and your SessionUUID. This is similar to looking up a company using the Carrier411 website and viewing the company information page. It returns a one-dimensional array with 114 elements, including insurance, authority, safety rating, SMS and census data.


The docket number must not have a space between the prefix and the 6-digit docket number, such as MC455455. The docket number string must be 8 characters, including the MC, FF or MX prefix. The prefix must be MC, FF or MX. The remainder of the docket number must be 6 numbers.


WSDL http://webservices.carrier411.com/wsGetCompany.cfc?wsdl
Method checkcompany
Signature string wsGetCompany.cfc( string param1, string param2 )
Purpose Returns safety rating, BASIC scores and SMS data, insurance, authority and census data for the specified MC FF MX number.
Errors

FaultCode 200: Not invoked as a web service.

FaultCode 201: SessionUUID not valid. Login required to establish session.

FaultCode 202: SessionUUID not provided. Login required to establish session.

FaultCode 203: Docketnumber string length must be eight characters including the MC FF MX prefix.

FaultCode 204: Invalid docketnumber prefix. Two character docketnumber prefix must be MC FF MX.

FaultCode 205: Docketnumber must have six numbers following the MC FF MX prefix.

FaultCode 206: Invalid docketnumber. Docketnumber could not be found.

Parameters

string param1 -- DocketNumber

string param2 -- SessionUUID

Returned

struct One-dimensional array with 114 elements.

Otherwise, a FaultCode is returned.

Refer to Figure 1 below for sample return data.


Logic Model for Setting Up New Carriers in TMS Using wsGetCompany



How to Instantiate wsGetCompany Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetCompany.cfc?wsdl"
   method="checkcompany"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="MC455455" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetCompany Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetCompany.cfc?wsdl',true);
$param1="MC455455"; //docketnumber
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("checkcompany",$params);

wsGetInsAuth.cfc  (insuranceauthority)

This function emulates the "Recent Insurance or Authority Changes" feature in the "Carrier Alerts" section of the Carrier411 website. It enables you to get information about your registered carriers that have been updated within the specified number of days. It is the same as being alerted to your registered carriers that have been updated, such as receiving an email alert. However, instead of simply identifying the companies that changed, this function returns a two-dimensional array that includes the docket number and 114 elements for each company. Elements for each company are the same as what is returned by the wsGetCompany function.


Insurance and authority is updated throughout the week, every Monday, Wednesday and Friday morning - usually by 7:30 AM EST. Once the update process is complete, the system will know which of your companies monitored changed that day. Invoke this process when updates are finished on those mornings.


Provide a one-digit number between 1 and 7 along with your SessionUUID. The number provided indicates the number of days this function uses to determine your registered carriers that changed. For example, if you specify 3, the function will return a list of your registered carriers whose insurance and authority information has been updated within the last 3 days. Specify 7 and this function will return all your carriers updated in the last 7 days.


WSDL http://webservices.carrier411.com/wsGetInsAuth.cfc?wsdl
Method insuranceauthority
Signature string wsGetInsAuth.cfc( string param1, string param2 )
Purpose Returns safety rating, SMS data, insurance, authority and census data for all your registered carriers that have had insurance or authority updates within the specified number of days.
Errors

FaultCode 300: Not invoked as a web service.

FaultCode 301: SessionUUID not valid. Login required to establish session.

FaultCode 302: SessionUUID not provided. Login required to establish session.

FaultCode 303: Number of days must be numeric.

FaultCode 304: Number of days must be between one and seven.

FaultCode 305: No registered companies updated.

Parameters

string param1 -- Number of days. Numeric value between 1 and 7.

string param2 -- SessionUUID

Returned struct Two-dimensional array with docketnumber(s) and 114 elements. Otherwise, a FaultCode is returned.

Logic Model for Updating Insurance and Authority Changes Using wsGetInsAuth



How to Instantiate wsGetInsAuth Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetInsAuth.cfc?wsdl"
   method="insuranceauthority"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="2" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetInsAuth Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetInsAuth.cfc?wsdl',true);
$param1=2; //number of days
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("insuranceauthority",$params);

wsGetFGReports.cfc  (checkfgreports)

The Carrier411 website has an integrated FreightGuard reporting system that lets members report companies (carriers, brokers, freight forwarders) for performance issues based on a variety of designated criteria:


  • • In-transit agreement modification
  • • Operates under alias
  • • Cancelled after accepting load
  • • Persistent cancelling
  • • Unresolved claim issues
  • • Unethical or deceptive business practices
  • • Repeated pickup or delivery service failures
  • • Fraudulent activity
 
  • • Held load hostage
  • • Operates without bond or trust fund
  • • Brokers freight without broker or FF authority
  • • Payment issues
  • • No show and no call
  • • Unauthorized re-brokering of shipment
  • • Back-solicited shipper
  • • Theft or unjustified loss of freight

FreightGuard report information can be obtained and maintained using the wsGetFGReports function. Information provided in FreightGuard reports are solely the opinions of members and not necessarily the opinions of Carrier411.


Invoking the wsGetFGReports function identifies all companies monitored by your account that have FreightGuard reports. To maintain accurate information in your TMS software database about companies with FreightGuard reports, we suggest you invoke the wsGetFGReports function one time each day in the morning. But before you process data returned by the wsGetFGReports function, we suggest you reset or clear all FreightGuard report information in your TMS Software database for all companies that previously had FreightGuard reports; Then you can process the data returned by the wsGetFGReports function. Because FreightGuard reports are submitted, released, edited, updated, and deleted every day, clearing any existing FreightGuard report information before processing data returned by the wsGetFGReports function is the only way you can maintain accurate FreightGuard report information.


WSDL http://webservices.carrier411.com/wsGetFGReports.cfc?wsdl
Method checkfgreports
Signature string wsGetFGReports.cfc( string param1 )
Purpose Returns two-dimensional array with information about FreightGuard reports that have been submitted and released for all companies monitored by your account.
Errors

FaultCode 1900: Not invoked as a web service.

FaultCode 1901: SessionUUID not valid. Login required to establish session.

FaultCode 1902: SessionUUID not provided. Login required to establish session.

FaultCode 1903: No registered companies have FreightGuard reports.

Parameters

string param1 -- SessionUUID

Returned struct Two-dimensional array with docketnumber(s) and 33 elements. Otherwise, a FaultCode is returned.

Information Returned by wsGetFGReports Function
The wsGetFGReports function returns a two-dimensional array that includes the docket number and 33 elements for each company reported.


1.  AGREEMENT CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "In-transit agreement modification".
2.  AGREEMENTCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "In-transit agreement modification" based on all FreightGuard reports submitted about company.
3.  ALIAS CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Operates under alias".
4.  ALIASCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Operates under alias" based on all FreightGuard reports submitted about company.
5.  CANCELLED CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Cancelled after accepting load".
6.  CANCELLEDCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Cancelled after accepting load" based on all FreightGuard reports submitted about company.
7.  CANCELLING CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Persistent cancelling".
8.  CANCELLINGCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Persistent cancelling" based on all FreightGuard reports submitted about company.
9.  CLAIMS CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Unresolved claim issues".
10.  CLAIMSCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Unresolved claim issues" based on all FreightGuard reports submitted about company.
11.  ETHICS CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Unethical or deceptive business practices".
12.  ETHICSCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Unethical or deceptive business practices" based on all FreightGuard reports submitted about company.
13.  FAILURES CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Repeated pickup or delivery service failures".
14.  FAILURESCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Repeated pickup or delivery service failures" based on all FreightGuard reports submitted about company.
15.  FRAUD CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Fraudulent activity".
16.  FRAUDCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Fraudulent activity" based on all FreightGuard reports submitted about company.
17.  HOSTAGE CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Held load hostage".
18.  HOSTAGECOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Held load hostage" based on all FreightGuard reports submitted about company.
19.  NOBOND CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Operates without bond or trust fund".
20.  NOBONDCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Operates without bond or trust fund" based on all FreightGuard reports submitted about company.
21.  NOLICENSE CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Brokers freight without broker or FF authority".
22.  NOLICENSECOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Brokers freight without broker or FF authority" based on all FreightGuard reports submitted about company.
23.  NONPAYMENT CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Payment issues".
24.  NONPAYMENTCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Payment issues" based on all FreightGuard reports submitted about company.
25.  NOSHOW CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "No show and no call".
26.  NOSHOWCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "No show and no call" based on all FreightGuard reports submitted about company.
27.  REBROKER CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Unauthorized re-brokering of shipment".
28.  REBROKERCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Unauthorized re-brokering of shipment" based on all FreightGuard reports submitted about company.
29.  REPORTS NUMERIC 9
Possible Values: Numeric value representing total number of FreightGuard reports submitted about company.
30.  SOLICITED CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Back-solicited shipper".
31.  SOLICITEDCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Back-solicited shipper" based on all FreightGuard reports submitted about company.
32.  THEFT CHAR 1
Possible Values: "Y" for yes or "N" for no. Indicates whether company has ever been reported for "Theft or unjustified loss of freight".
33.  THEFTCOUNT NUMERIC 9
Possible Values: Numeric value representing total number of times company has been reported for "Theft or unjustified loss of freight" based on all FreightGuard reports submitted about company.

How to Instantiate wsGetFGReports Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetFGReports.cfc?wsdl"
   method="checkfgreports"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetFGReports Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetFGReports.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("checkfgreports",$params);

wsSafetyDate.cfc  (safetydate)

Carrier safety ratings are constantly verified and updated throughout the week, plus a carrier safety rating data file is processed about every two to four weeks when the new data file is provided by the FMCSA. Because carrier safety ratings are updated on a daily basis, you should to invoke the wsGetSafetyUpdates function once a day to update carrier safety ratings for your registered carriers.


You can invoke the wsSafetyDate function to check the date carrier safety ratings were last updated in our database. However, the wsSafetyDate function will always return the current date, because Carrier411 has processes that verify and update carrier safety ratings as needed on a daily basis.


The date value returned by wsSafetyDate should be stored in your database for reference. When making a function call to wsSafetyDate, compare the date returned to the date stored in your database. If the date returned is greater than the date last recorded in your database, then you will want to invoke the wsGetSafetyUpdates funtion to update safety ratings for your registered carriers. Subsequently, you will also want to update the date stored with the new date returned by wsSafetyDate.


WSDL http://webservices.carrier411.com/wsSafetyDate.cfc?wsdl
Method safetydate
Signature string wsSafetyDate.cfc( string param1 )
Purpose Returns the date carrier safety ratings last updated.
Errors

FaultCode 800: Not invoked as a web service.

FaultCode 801: SessionUUID not valid. Login required to establish session.

FaultCode 802: SessionUUID not provided. Login required to establish session.

Parameters string param1 -- SessionUUID
Returned

struct One-dimensional array with date.

Otherwise, a FaultCode is returned.


How to Instantiate wsSafetyDate Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsSafetyDate.cfc?wsdl"
   method="safetydate"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsSafetyDate Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsSafetyDate.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("safetydate",$params);

wsGetSafetyUpdates.cfc  (checksafetyupdates)

This function returns carrier safety ratings for all registered carriers monitored by your Carrier411 account updated within two months of last safety rating update. If you only want to obtain safety ratings that have been updated, wsGetSafetyUpdates is the most efficient function to use for that purpose. wsGetSafetyUpdates is also much more efficient than invoking wsGetAllSafety, which returns safety ratings for all registered carriers (regardless of whether the safety rating was updated).


This function returns a two-dimensional array that only includes the docket number and safety ratings - SAFETYRATEDATE, SAFETYRATING, SAFETYREVDATE and SAFETYREVTYPE. Please refer to Possible Values for Safety Ratings at the bottom of this document to understand the specific safety rating data that is returned.


Carrier safety ratings are constantly verified and updated throughout the week, plus a carrier safety rating data file is processed about every two to four weeks when the new data file is provided by the FMCSA. Invoke the wsSafetyDate function first to determine whether is is necessary to invoke this function.


WSDL http://webservices.carrier411.com/wsGetSafetyUpdates.cfc?wsdl
Method checksafetyupdates
Signature string wsGetSafetyUpdates.cfc( string param1 )
Purpose Returns carrier safety ratings that have been updated for all registered companies.
Errors

FaultCode 1700: Not invoked as a web service.

FaultCode 1701: SessionUUID not valid. Login required to establish session.

FaultCode 1702: SessionUUID not provided. Login required to establish session.

FaultCode 1703: No registered companies match search.

Parameters string param1 -- SessionUUID
Returned struct Two-dimensional array with docketnumber(s) and safety ratings. Otherwise, a FaultCode is returned.

Logic Model for Updating Carrier Safety Ratings Using wsGetSafetyUpdates



How to Instantiate wsGetSafetyUpdates Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetSafetyUpdates.cfc?wsdl"
   method="checksafetyupdates"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetSafetyUpdates Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetSafetyUpdates.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("checksafetyupdates",$params);

wsGetAllSafety.cfc  (checkallsafety)

Despite availability of the wsGetAllSafety function, we highly recommend using the wsGetSafetyUpdates function instead, because wsGetSafetyUpdates is more efficient and effective. wsGetSafetyUpdates returns carrier safety ratings for registered companies monitored by your account that were updated within two months of last safety rating update.


The wsGetAllSafety function returns carrier safety ratings for all registered carriers monitored by your Carrier411 account. If you want to obtain safety ratings for all registered companies monitored by your account, regardless of the date their safety ratings were last updated, then wsGetAllSafety is the function to use for that purpose.


This function returns a two-dimensional array that only includes the docket number and safety ratings - SAFETYRATEDATE, SAFETYRATING, SAFETYREVDATE and SAFETYREVTYPE. Please refer to Possible Values for Safety Ratings at the bottom of this document to understand the specific safety rating data that is returned.


Carrier safety ratings are constantly verified and updated throughout the week, plus a carrier safety rating data file is processed about every two to four weeks when the new data file is provided by the FMCSA. Invoke the wsSafetyDate function first to determine whether is is necessary to invoke this function.


WSDL http://webservices.carrier411.com/wsGetAllSafety.cfc?wsdl
Method checkallsafety
Signature string wsGetAllSafety.cfc( string param1 )
Purpose Returns carrier safety ratings for all registered companies.
Errors

FaultCode 1100: Not invoked as a web service.

FaultCode 1101: SessionUUID not valid. Login required to establish session.

FaultCode 1102: SessionUUID not provided. Login required to establish session.

FaultCode 1103: No registered companies match search.

Parameters string param1 -- SessionUUID
Returned struct Two-dimensional array with docketnumber(s) and safety ratings. Otherwise, a FaultCode is returned.

How to Instantiate wsGetAllSafety Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetAllSafety.cfc?wsdl"
   method="checkallsafety"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetAllSafety Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetAllSafety.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("checkallsafety",$params);

wsSMSDate.cfc  (smsdate)

Safety Measurement System (SMS) data is updated once a month, usually during the first week. SMS data is not updated again until the next month. Therefore, it is only necessary to invoke the wsGetAllSMS function to update SMS data for your registered carriers once a month, after SMS data is updated in our database, as determined by invoking the wsSMSDate function. In other words, to determine whether you should invoke the wsGetAllSMS function, first invoke the wsSMSDate function to check the date SMS data was last updated in our database.


The date value returned by wsSMSDate should be stored in your database for reference. When making a function call to wsSMSDate, compare the date returned to the date stored in your database. If the date returned is greater than the date last recorded in your database, then you will want to invoke the wsGetAllSMS funtion to update SMS data for all your registered carriers. Subsequently, you will also want to update the date stored with the new date returned by wsSMSDate.


WSDL http://webservices.carrier411.com/wsSMSDate.cfc?wsdl
Method smsdate
Signature string wsSMSDate.cfc( string param1 )
Purpose Returns the date SMS BASIC scores last updated.
Errors

FaultCode 900: Not invoked as a web service.

FaultCode 901: SessionUUID not valid. Login required to establish session.

FaultCode 902: SessionUUID not provided. Login required to establish session.

Parameters string param1 -- SessionUUID
Returned

struct One-dimensional array with date.

Otherwise, a FaultCode is returned.


How to Instantiate wsSMSDate Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsSMSDate.cfc?wsdl"
   method="smsdate"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsSMSDate Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsSMSDate.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("smsdate",$params);

wsGetAllSMS.cfc  (checkallsms)

This function returns Safety Measurement System (SMS) data for all registered carriers monitored by your Carrier411 account. It returns a two-dimensional array that only includes the docket number and all SMS data, including BASIC scores. Please refer to Possible Values for Safety Measurement System Data at the bottom of this document to understand the specific SMS data that is returned.


SMS data is updated once a month, usually during the first week. Once SMS data is released for the month, it does not change until the next month.


Invoke the wsSMSDate function first to determine whether is is necessary to invoke this function.


WSDL http://webservices.carrier411.com/wsGetAllSMS.cfc?wsdl
Method checkallsms
Signature string wsGetAllSMS.cfc( string param1 )
Purpose Returns SMS data for all companies monitored.
Errors

FaultCode 1000: Not invoked as a web service.

FaultCode 1001: SessionUUID not valid. Login required to establish session.

FaultCode 1002: SessionUUID not provided. Login required to establish session.

FaultCode 1003: No registered companies match search.

Parameters string param1 -- SessionUUID
Returned struct Two-dimensional array with docketnumber(s) and SMS data. Otherwise, a FaultCode is returned.

Logic Model for Updating SMS Data Using wsGetAllSMS



How to Instantiate wsGetAllSMS Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetAllSMS.cfc?wsdl"
   method="checkallsms"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetAllSMS Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetAllSMS.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("checkallsms",$params);

wsStartMonitoring.cfc  (startmonitoring)

This function enables you to add a carrier to the list of registered carriers monitored by your Carrier411 account. Provide the MC, FF or MX number and your SessionUUID. It emulates looking up a carrier and clicking the "Start Monitoring" button in the Carrier411 website. If the specified carrier is already registered for your account, a duplicate entry will not be made.


This function returns ResponseCode 0 if the company was previously registered. Otherwise, it returns ResponseCode 1 upon registering (adding) the carrier, indicating it is now monitored by your Carrier411 account.


WSDL http://webservices.carrier411.com/wsStartMonitoring.cfc?wsdl
Method startmonitoring
Signature string wsStartMonitoring.cfc( string param1, string param2 )
Purpose Adds registered company to your Carrier411 account.
Errors

FaultCode 600: Not invoked as a web service.

FaultCode 601: SessionUUID not valid. Login required to establish session.

FaultCode 602: SessionUUID not provided. Login required to establish session.

FaultCode 603: Docketnumber string length must be eight characters including the MC FF MX prefix.

FaultCode 604: Invalid docketnumber prefix. Two character docketnumber prefix must be MC FF MX.

FaultCode 605: Docketnumber must have six numbers following the MC FF MX prefix.

FaultCode 606: Invalid docketnumber. Docketnumber could not be found.

Parameters

string param1 -- DocketNumber

string param2 -- SessionUUID

Returned

struct ResponseCode 0: Company already registered.

struct ResponseCode 1: Company successfully registered.

Otherwise, a FaultCode is returned.


Logic Model for Adding Carriers to Monitoring List Using wsStartMonitoring



How to Instantiate wsStartMonitoring Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsStartMonitoring.cfc?wsdl"
   method="startmonitoring"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="MC455455" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsStartMonitoring Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsStartMonitoring.cfc?wsdl',true);
$param1="MC455455"; //docketnumber
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("startmonitoring",$params);

wsStopMonitoring.cfc  (stopmonitoring)

This function enables you to delete a carrier from the list of registered carriers monitored by your Carrier411 account. Provide the MC, FF or MX number and your SessionUUID. It emulates looking up a carrier and clicking the "Stop Monitoring" button in the Carrier411 website.


This function returns ResponseCode 0 if the company was not registered. Otherwise, it returns ResponseCode 1 upon deleting the carrier, indicating it is no longer monitored by your Carrier411 account.


WSDL http://webservices.carrier411.com/wsStopMonitoring.cfc?wsdl
Method stopmonitoring
Signature string wsStopMonitoring.cfc( string param1, string param2 )
Purpose Deletes registered company from your Carrier411 account.
Errors

FaultCode 700: Not invoked as a web service.

FaultCode 701: SessionUUID not valid. Login required to establish session.

FaultCode 702: SessionUUID not provided. Login required to establish session.

FaultCode 703: Docketnumber string length must be eight characters including the MC FF MX prefix.

FaultCode 704: Invalid docketnumber prefix. Two character docketnumber prefix must be MC FF MX.

FaultCode 705: Docketnumber must have six numbers following the MC FF MX prefix.

Parameters

string param1 -- DocketNumber

string param2 -- SessionUUID

Returned

struct ResponseCode 0: Company not registered.

struct ResponseCode 1: Company deleted from monitoring list.

Otherwise, a FaultCode is returned.


Logic Model for Removing Carriers from Monitoring List Using wsStopMonitoring



How to Instantiate wsStopMonitoring Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsStopMonitoring.cfc?wsdl"
   method="stopmonitoring"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="MC455455" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsStopMonitoring Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsStopMonitoring.cfc?wsdl',true);
$param1="MC455455"; //docketnumber
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("stopmonitoring",$params);

wsGetInsPols.cfc  (activeinsurance)

This function enables you to retrieve insurance policy information for a company. Provide MC, FF or MX number and your SessionUUID.


WSDL http://webservices.carrier411.com/wsGetInsPols.cfc?wsdl
Method activeinsurance
Signature string wsGetInsPols.cfc( string param1, string param2 )
Purpose Returns information about each known insurance policy for the specified MC FF MX number.
Errors

FaultCode 1200: Not invoked as a web service.

FaultCode 1201: SessionUUID not valid. Login required to establish session.

FaultCode 1202: SessionUUID not provided. Login required to establish session.

FaultCode 1203: Docketnumber string length must be eight characters including the MC FF MX prefix.

FaultCode 1204: Invalid docketnumber prefix. Two character docketnumber prefix must be MC FF MX.

FaultCode 1205: Docketnumber must have six numbers following the MC FF MX prefix.

FaultCode 1206: Invalid docketnumber. Docketnumber could not be found.

FaultCode 1207: No insurance policy information available.

Parameters

string param1 -- DocketNumber

string param2 -- SessionUUID

Returned struct Two-dimensional array with information about each known insurance policy. Otherwise, a FaultCode is returned.

Information Returned by wsGetInsPols Function
The wsGetInsPols function returns a two-dimensional array with information about each known insurance policy.


1.  FMCSADOCKETNUMBER CHAR 8
This is the motor carrier (MC) number for the company. It may also be an FF or MX number for freight forwarders or Mexican carriers.
2.  INSURCOMPANY VARCHAR 45
Insurance company (underwriter) for the policy.
3.  INSURADDRESS VARCHAR 35
Insurance company (underwriter) address for the policy.
4.  INSURCITY VARCHAR 30
City where insurance company (underwriter) is located.
5.  INSURSTATE CHAR 2
State where insurance company (underwriter) is located.
6.  INSURZIP VARCHAR 10
Zip code where insurance company (underwriter) is located.
7.  INSURPHONE VARCHAR 14
Insurance company (underwriter) telephone number.
8.  INSURFAX VARCHAR 14
Insurance company (underwriter) fax number.
9.  INSUREFFECTIVE DATETIME
Date the specified insurance policy was first issued.
10.  INSURPOLICYNUM VARCHAR 25
Insurance policy number for the specified policy.
11.  INSURTYPE VARCHAR 14
Type of insurance for specified policy. Possible Values: BIPD, BIPD PRIMARY, BIPD EXCESS, CARGO, BOND, TRUST FUND.
12.  INSURTYPECODE VARCHAR 5
Type code for specified policy.
13.  INSURBIPDFROM VARCHAR 10
This value (data element) is not provided for cargo policies, as it relates only to BIPD policies. This value indicates the starting dollar amount of liability insurance on file for the company, as reported to the FMCSA by the insurance underwriter. Even though BIPD insurance may not be required, some companies will maintain a BIPD insurance policy. The value will usually be 0 (zero) for $750,000 BIPD policies. BIPD EXCESS policies will often have a from value of $1,000,000.
14.  INSURBIPDTO VARCHAR 10
This value (data element) is not provided for cargo policies, as it relates only to BIPD policies. This value indicates the amount of coverage for the specified BIPD insurance policy, as reported to the FMCSA by the insurance underwriter. BIPD is bodily injury property damage, more commonly known as liability insurance.

How to Instantiate wsGetInsPols Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetInsPols.cfc?wsdl"
   method="activeinsurance"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="MC455455" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetInsPols Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetInsPols.cfc?wsdl',true);
$param1="MC455455"; //docketnumber
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("activeinsurance",$params);

wsGet411Status.cfc  (checkmonitoring)

This function determines whether the company is monitored by your Carrier411 account. Provide the MC, FF or MX number and your SessionUUID.


This function returns ResponseCode 0 if the company is not registered in your Carrier411 account. i.e. ResponseCode 0 indicates the company is not monitored. Otherwise, it returns ResponseCode 1 to indicate the company is registered and monitored by your Carrier411 account.


One practical use for this function is to determine whether you need to display a "Start Monitoring" button or a "Stop Monitoring" button in your software application when users view information about the company.


WSDL http://webservices.carrier411.com/wsGet411Status.cfc?wsdl
Method checkmonitoring
Signature string wsGet411Status.cfc( string param1, string param2 )
Purpose Determines whether company is monitord by your Carrier411 account as a registered carrier.
Errors

FaultCode 1300: Not invoked as a web service.

FaultCode 1301: SessionUUID not valid. Login required to establish session.

FaultCode 1302: SessionUUID not provided. Login required to establish session.

FaultCode 1303: Docketnumber string length must be eight characters including the MC FF MX prefix.

FaultCode 1304: Invalid docketnumber prefix. Two character docketnumber prefix must be MC FF MX.

FaultCode 1305: Docketnumber must have six numbers following the MC FF MX prefix.

Parameters

string param1 -- DocketNumber

string param2 -- SessionUUID

Returned

struct ResponseCode 0: Company not monitored.

struct ResponseCode 1: Company monitored.

Otherwise, a FaultCode is returned.


How to Instantiate wsGet411Status Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGet411Status.cfc?wsdl"
   method="checkmonitoring"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="MC455455" />
   <cfinvokeargument name="param2" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGet411Status Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGet411Status.cfc?wsdl',true);
$param1="MC455455"; //docketnumber
$param2="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1,$param2);

$results=$client->call("checkmonitoring",$params);

wsGetDocketList.cfc  (getlist)

This function enables you to retrieve a list of docket numbers for all registered carriers monitored by your Carrier411 account. It returns a two-dimensional array with the docket number, date registered and the date insurance and authority information was last updated for the company.


WSDL http://webservices.carrier411.com/wsGetDocketList.cfc?wsdl
Method getlist
Signature string wsGetDocketList.cfc( string param1 )
Purpose Returns docket numbers and dates for all registered companies monitored by your account.
Errors

FaultCode 1400: Not invoked as a web service.

FaultCode 1401: SessionUUID not valid. Login required to establish session.

FaultCode 1402: SessionUUID not provided. Login required to establish session.

FaultCode 1403: No registered companies.

Parameters string param1 -- SessionUUID
Returned

struct Two-dimensional array with docket numbers and dates for all registered companies monitored by your account.

Otherwise, a FaultCode is returned.


How to Instantiate wsGetDocketList Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetDocketList.cfc?wsdl"
   method="getlist"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetDocketList Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetDocketList.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("getlist",$params);

wsGetAllAuth.cfc  (getallauthority)

This function only returns data about inusurance and authority for all registered carriers monitored by your Carrier411 account in a two-dimensional array with the docket number(s).


The wsGetAllAuth function is different than wsGetInsAuth, which returns information about registered carriers that were updated within a specified number of days.


Instead, wsGetAllAuth returns information for all registered carriers monitored, regardless of when they were last updated. The wsGetAllAuth function returns limited information for insurance and authority only and does not provide other information, such as safety ratings, SMS or census data.


WSDL http://webservices.carrier411.com/wsGetAllAuth.cfc?wsdl
Method getallauthority
Signature string wsGetAllAuth.cfc( string param1 )
Purpose Returns only insurance and authority data for all your registered carriers, regardless of when the information last changed.
Errors

FaultCode 1500: Not invoked as a web service.

FaultCode 1501: SessionUUID not valid. Login required to establish session.

FaultCode 1502: SessionUUID not provided. Login required to establish session.

FaultCode 1503: No registered companies.

Parameters string param1 -- SessionUUID
Returned struct Two-dimensional array with docketnumber(s) along with information about insurance and authority.

How to Instantiate wsGetAllAuth Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetAllAuth.cfc?wsdl"
   method="getallauthority"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetAllAuth Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetAllAuth.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("getallauthority",$params);

wsInsAuthDateTime.cfc  (insauthdatetime)

FMCSA data for insurance and authority updates is processed by our system every Monday, Wednesday and Friday morning.


To determine whether you should invoke the wsGetInsAuth function that day (which is used to update your system for insurance and authority changes in the companies monitored by your Carrier411 account), first invoke the wsInsAuthDateTime function to check the date and time insurance and authority changes were last updated in our master database.


The values returned by wsInsAuthDateTime should be stored and kept updated in your database. The time value is based on Eastern Standard Time (EST).


wsInsAuthDateTime is a function you will want to invoke once a day throughout the business week (Monday through Friday) in the morning, usually about 10:00 AM EST. The reason for invoking wsInsAuthDateTime about 10:00 AM EST is to ensure you do not invoke it (and subsequently the wsGetInsAuth function) before our insurance and authority updates complete processing that morning.


Again, the date and time values returned by wsInsAuthDateTime should be stored in your database for reference.


When making a function call to wsInsAuthDateTime, compare the date and time it returns to the stored date and time in your system (for the last insurance and authority update to our master database). If the date returned is today's date, then you will want to invoke the wsGetInsAuth funtion to update insurance and authority information for your registered carriers.


Be sure to compare the date stored in your database with the date returned by wsInsAuthDateTime to determine the numeric parameter required for the wsGetInsAuth function (a one-digit number between 1 and 7 that indicates the number of days wsGetInsAuth uses to determine your carriers that changed).


WSDL http://webservices.carrier411.com/wsInsAuthDateTime.cfc?wsdl
Method insauthdatetime
Signature string wsInsAuthDateTime.cfc( string param1 )
Purpose Returns the date and time our master database was last updated for insurance and authority changes.
Errors

FaultCode 1600: Not invoked as a web service.

FaultCode 1601: SessionUUID not valid. Login required to establish session.

FaultCode 1602: SessionUUID not provided. Login required to establish session.

Parameters string param1 -- SessionUUID
Returned

struct One-dimensional array with date and time insurance and authority updates were last processed for our master database.

Otherwise, a FaultCode is returned.


How to Instantiate wsInsAuthDateTime Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsInsAuthDateTime.cfc?wsdl"
   method="insauthdatetime"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsInsAuthDateTime Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsInsAuthDateTime.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("insauthdatetime",$params);

wsGetAllOOS.cfc  (ooscarriers)

This function emulates the "OOS Alerts" feature available in the blue toolbar of the Carrier411 website. It enables you to get information about your registered carriers that have been issued Out of Service (OOS) Orders. When an Out of Service (OOS) Order is issued by the FMCSA, the carrier is ordered to cease all motor vehicle operations regardless of operating authority status. Any carrier that has an Out of Service (OOS) Order should not be used until the FMCSA rescinds the OOS order.


Carrier411 has processes that check and verify OOS Orders on daily basis. OOS Orders can be issued and rescinded by the FMCSA at any time, so it is important to invoke the wsGetAllOOS function one time each day in the morning to obtain a complete list of all companies monitored that have Out of Service (OOS) Orders.


The wsGetAllOOS function is similar to the wsGetInsAuth function in terms of the data it returns, along with the structure of that data. The wsGetInsAuth function returns a two-dimensional array that includes the docket number and 114 elements for each company. The wsGetAllOOS function also returns a two-dimensional array that includes the docket number and the same 114 elements for each company, plus two additional elements (FMCSAOOSORDER and FMCSAOOSORDERDATE) for a total of 116 elements. The FMCSAOOSORDER element will have a "Y" value indicating the carrier has an OOS Order. The FMCSAOOSORDERDATE element indicates the date that our system initially detected or re-verified the OOS Order, and it is not necessarily the date the OOS Order was issued.


To prevent data parsing issues with the wsGetCompany and wsGetInsAuth functions, we have not included the FMCSAOOSORDER and FMCSAOOSORDERDATE elements as part of the data returned by the wsGetCompany and wsGetInsAuth functions. The only function that identifies out of service carriers is wsGetAllOOS.


Invoking the wsGetAllOOS function identifies all companies monitored by your account that have an OOS Order. To maintain accurate information in your TMS software database about carriers that have OOS Orders, we suggest you invoke the wsGetAllOOS function one time each day in the morning. But before you process data returned by the wsGetAllOOS function, we suggest you reset or clear the OOS Order status in your TMS Software database for all companies that previously had an OOS Order; Then you can process the data returned by the wsGetAllOOS function. Because OOS Orders can be rescinded by the FMCSA, clearing any existing OOS Order statuses before processing data returned by the wsGetAllOOS function is the only way you can maintain accurate OOS Order statuses.


Any carrier with an Out of Service (OOS) Order that previously had a carrier safety rating (satisfactory, conditional, unsatisfactory) will have its carrier safety rating reset to a NULL value, indicating the carrier's current carrier safety rating is NONE. This process of of resetting the carrier safety rating is consistent with the way FMCSA presents information on the SaferSys website for carriers that have an Out of Service (OOS) Order. If you check the SaferSys website for a carriers that has an Out of Service (OOS) Order, no carrier safety rating information will be displayed.


WSDL http://webservices.carrier411.com/wsGetAllOOS.cfc?wsdl
Method ooscarriers
Signature string wsGetAllOOS.cfc( string param1 )
Purpose Returns two-dimensional array with safety rating, SMS data, insurance, authority and census data for all companies monitored by your account that have Out of Service (OOS) Orders issued by the FMCSA, requiring the carriers to cease all motor vehicle operations.
Errors

FaultCode 1800: Not invoked as a web service.

FaultCode 1801: SessionUUID not valid. Login required to establish session.

FaultCode 1802: SessionUUID not provided. Login required to establish session.

FaultCode 1803: No Registered Companies Ordered Out of Service.

Parameters

string param1 -- SessionUUID

Returned struct Two-dimensional array with docketnumber(s) and 116 elements, including FMCSAOOSORDER and FMCSAOOSORDERDATE. Otherwise, a FaultCode is returned.

How to Instantiate wsGetAllOOS Function Using ColdFusion


<cfinvoke webservice="http://webservices.carrier411.com/wsGetAllOOS.cfc?wsdl"
   method="ooscarriers"
   returnvariable="carrier411data">
   <cfinvokeargument name="param1" value="FB1F7AE1-3048-71E3-611C9EE38EC1572F" />
</cfinvoke>

How to Instantiate wsGetAllOOS Function with PHP Using NuSoap Libraries


include("nusoap.php");

$client= new 
soapclient('http://webservices.carrier411.com/wsGetAllOOS.cfc?wsdl',true);
$param1="FB1F7AE1-3048-71E3-611C9EE38EC1572F"; //sessionuuid
$params=array($param1);

$results=$client->call("ooscarriers",$params);

Figure 1: Data Returned for Docket Number

struct
CENSUSBEVERAGES [empty string]
CENSUSBLDGMAT X
CENSUSCARGOOTHR [empty string]
CENSUSCHEM X
CENSUSCLASS A
CENSUSCLASSDEF [empty string]
CENSUSCOALCOKE [empty string]
CENSUSCOLDFOOD X
CENSUSCONSTRUCT [empty string]
CENSUSDBNUM [empty string]
CENSUSDRIVETOW [empty string]
CENSUSDRYBULK X
CENSUSEMAILADDRESS RASTEPTAXPLACE@ALLTEL.NET
CENSUSFARMSUPP [empty string]
CENSUSGARBAGE [empty string]
CENSUSGENFREIGHT X
CENSUSGRAINFEED X
CENSUSHOUSEHOLD [empty string]
CENSUSINTERMODAL [empty string]
CENSUSLIQGAS [empty string]
CENSUSLIVESTOCK [empty string]
CENSUSLOGPOLE X
CENSUSMACHLRG [empty string]
CENSUSMCS150DATE 08/08/2006
CENSUSMCS150MILEAGEYEAR 2004
CENSUSMEAT X
CENSUSMETALSHEET [empty string]
CENSUSMLG150 240000
CENSUSMOBILEHOME [empty string]
CENSUSMOTORVEH [empty string]
CENSUSOILFIELD [empty string]
CENSUSOTHERCARGO [empty string]
CENSUSOWNTRACT 4
CENSUSOWNTRAIL 4
CENSUSPAPERPROD X
CENSUSPASSENGERS [empty string]
CENSUSPRODUCE X
CENSUSTOTDRS 3
CENSUSTOTPWR 4
CENSUSTRMTRACT 0
CENSUSTRMTRAIL 0
CENSUSUSMAIL X
CENSUSUTILITY [empty string]
CENSUSWATERWELL [empty string]
FMCSAAPPLICANTID 368224
FMCSABIPDFILED 0
FMCSABIPDREQUIRED 750000
FMCSABONDFILED N
FMCSABONDREQUIRED N
FMCSABROKER N
FMCSABUSADDRESS 109 S. DOOLY ST.
FMCSABUSCITY MONTEZUMA
FMCSABUSCOUNTRY US
FMCSABUSFAX [empty string]
FMCSABUSPHONE 4784725773
FMCSABUSSTATE GA
FMCSABUSZIP 31063
FMCSACARGOFILED N
FMCSACARGOREQUIRED Y
FMCSACOMMON I
FMCSACONTRACT N
FMCSADATELASTUPDATED 11/03/2006
FMCSADBANAME STEPHENS' TRUCK LINE
FMCSADOCKETNUMBER MC455455
FMCSADOTNUMBER 1228268
FMCSAFREIGHT Y
FMCSAHOUSEHOLD N
FMCSALEGALNAME R A STEPHENS
FMCSAMAILADDRESS P O BOX 457
FMCSAMAILCITY MONTEZUMA
FMCSAMAILCOUNTRY US
FMCSAMAILFAX [empty string]
FMCSAMAILPHONE [empty string]
FMCSAMAILSTATE GA
FMCSAMAILZIP 31063
FMCSAPASSENGER N
FMCSAPENDINGBROKER N
FMCSAPENDINGCOMMON N
FMCSAPENDINGCONTRACT N
FMCSAREVOKINGBROKER N
FMCSAREVOKINGCOMMON N
FMCSAREVOKINGCONTRACT N
SAFESTATDRSEA [empty string]
SAFESTATSMSEA [empty string]
SAFESTATVHSEA [empty string]
SAFETYRATEDATE 07/26/2006
SAFETYRATING C
SAFETYREVDATE 05/11/2006
SAFETYREVTYPE C
SMSCONTRSUBSTBASICALERT N
SMSCONTRSUBSTPCT [empty string]
SMSCONTRSUBSTRDALERT N
SMSCONTRSUBSTSV N
SMSDRIVFITBASICALERT N
SMSDRIVFITPCT [empty string]
SMSDRIVFITRDALERT N
SMSDRIVFITSV N
SMSDRIVINSPTOTAL [empty string]
SMSDRIVOOSINSPTOTAL [empty string]
SMSFATIGUEDRIVBASICALERT N
SMSFATIGUEDRIVPCT 34.5
SMSFATIGUEDRIVRDALERT N
SMSFATIGUEDRIVSV N
SMSINSPTOTAL [empty string]
SMSUNSAFEDRIVBASICALERT N
SMSUNSAFEDRIVPCT [empty string]
SMSUNSAFEDRIVRDALERT N
SMSUNSAFEDRIVSV N
SMSVEHINSPTOTAL [empty string]
SMSVEHMAINTBASICALERT Y
SMSVEHMAINTPCT 89.1
SMSVEHMAINTRDALERT Y
SMSVEHMAINTSV N
SMSVEHOOSINSPTOTAL [empty string]

Structure Elements and Possible Values

1.  CENSUSBEVERAGES CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Beverages".
2.  CENSUSBLDGMAT CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Building Materials".
3.  CENSUSCARGOOTHR CHAR 1
Possible Values: X or NULL. When value is X then display the type of cargo specified in the value for CENSUSOTHERCARGO.
4.  CENSUSCHEM CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Chemicals".
5.  CENSUSCLASS VARCHAR 12

Possible Values: ABCDEFGHIJKL. Values indicate the carrier's "Operation Classification". Carriers can have more than one type of classification. Therefore, this field may contain an alpha string with multiple values. i.e. AGHL


Values listed are consecutive. You must read through the alpha string to identify individual classifications:


  • A = Authorized-for-Hire
  • B = Exempt-for-Hire
  • C = Private (Property)
  • D = Private/Passenger Business
  • E = Private/Passenger Non-Business
  • F = Migrant
  • G = U.S. Mail
  • H = Federal Government
  • I = State Government
  • J = Local Government
  • K = Indian Tribe
  • L = Display text in CENSUSCLASSDEF

When the CENSUSCLASS value string contains L then display the textual value indicated in CENSUSCLASSDEF.

6.  CENSUSCLASSDEF VARCHAR 50
Possible Values: NULL or Text. Display the text in CENSUSCLASSDEF when the CENSUSCLASS alpha string contains L as explained above. This value represents an Operation Classification designated by the carrier.
7.  CENSUSCOALCOKE CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Coal/Coke".
8.  CENSUSCOLDFOOD CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Refrigerated Food".
9.  CENSUSCONSTRUCT CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Construction".
10.  CENSUSDBNUM VARCHAR 9
Possible Values: NULL or number. This is the carrier's Dun & Bradstreet number.
11.  CENSUSDRIVETOW CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Drive/Tow Away".
12.  CENSUSDRYBULK CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Commodities Dry Bulk".
13.  CENSUSEMAILADDRESS VARCHAR 80
Possible Values: NULL or text. This is the carrier's email address. It can be linked with a mailto tag if desired.
14.  CENSUSFARMSUPP CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Agricultural/Farm Supplies".
15.  CENSUSGARBAGE CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Garbage/Refuse".
16.  CENSUSGENFREIGHT CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "General Freight".
17.  CENSUSGRAINFEED CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Grain, Feed, Hay".
18.  CENSUSHOUSEHOLD CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Household Goods".
19.  CENSUSINTERMODAL CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Intermodal Containers".
20.  CENSUSLIQGAS CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Liquids/Gases".
21.  CENSUSLIVESTOCK CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Livestock".
22.  CENSUSLOGPOLE CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Logs, Poles, Beams, Lumber".
23.  CENSUSMACHLRG CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Machinery, Large Objects".
24.  CENSUSMCS150DATE DATETIME
Possible Values: NULL or Date formatted as mm/dd/yyyy. This is the date the carrier filed its most recent MCS-150 form with the FMCSA.
25.  CENSUSMCS150MILEAGEYEAR INTEGER 4
Possible Values: NULL or 4-digit year. This is the year for reported "Mileage" on the MCS-150 form. Even though there is census data and a year value exists for CENSUSMCS150DATE, this field may be NULL. This value is associated with the "Mileage" indicated in CENSUSMLG150.
26.  CENSUSMEAT CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Meat".
27.  CENSUSMETALSHEET CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Metal (Sheets, Coils, Rolls)".
28.  CENSUSMLG150 INTEGER 4
Possible Values: NULL or number. This is reported "Mileage" on the MCS-150 form. Even though there is census data and a year value exists for CENSUSMCS150DATE, this field may be NULL. This value is associated with the CENSUSMCS150MILEAGEYEAR value.
29.  CENSUSMOBILEHOME CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Mobile Homes".
30.  CENSUSMOTORVEH CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Motor Vehicles".
31.  CENSUSOILFIELD CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Oilfield Equipment".
32.  CENSUSOTHERCARGO VARCHAR 50
Possible Values: NULL or whatever text was specified by the carriers when completing FMCSA documents. Display whatever textual information is provided when CENSUSCARGOOTHR value is X.
33.  CENSUSOWNTRACT VARCHAR 5
Possible Values: NULL or numeric value. This value indicates the total number of "Owned Tractors" operated by the carrier.
34.  CENSUSOWNTRAIL VARCHAR 5
Possible Values: NULL or numeric value. This value indicates the total number of "Owned Trailers" operated by the carrier.
35.  CENSUSPAPERPROD CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Paper Products".
36.  CENSUSPASSENGERS CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Passengers".
37.  CENSUSPRODUCE CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Fresh Produce".
38.  CENSUSTOTDRS VARCHAR 6
Possible Values: NULL or numeric value. This value indicates the total number of "Drivers" working for the carrier.
39.  CENSUSTOTPWR VARCHAR 6
Possible Values: NULL or numeric value. This value indicates the total number of "Power Units" operated by the carrier.
40.  CENSUSTRMTRACT VARCHAR 5
Possible Values: NULL or numeric value. This value indicates the total number of "Leased Tractors" operated by the carrier.
41.  CENSUSTRMTRAIL VARCHAR 5
Possible Values: NULL or numeric value. This value indicates the total number of "Leased Trailers" operated by the carrier.
42.  CENSUSUSMAIL CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "U.S. Mail".
43.  CENSUSUTILITY CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Utilities".
44.  CENSUSWATERWELL CHAR 1
Possible Values: X or NULL. Indicates whether carrier designated this as a type of cargo carried. When value is X then indicate "Water Well".
45.  FMCSAAPPLICANTID VARCHAR 10
The FMCSAAPPLICANTID value must be used for linking to the FMCSA website in order to display the Authority History, Revocation History, Active/Pending Insurance and Insurance History for an MC number. The FMCSAAPPLICANTID value for an MC number is unique to the specific MC number. As used above in the example links for MC455455, the FMCSAAPPLICANTID value is required for the pv_apcant_id name value pair. The pv_apcant_id value for MC455455 is 368224.
46.  FMCSABIPDFILED VARCHAR 10
This value indicates the dollar amount of liability insurance on file for the company, as reported to the FMCSA by insurance underwriters. Even though BIPD insurance may not be required, some companies will maintain a BIPD insurance policy.
47.  FMCSABIPDREQUIRED VARCHAR 10
BIPD is bodily injury property damage, more commonly known as liability insurance. If BIPD is required by the FMCSA, the minimum dollar amount of required coverage will be specified. If required, the minimum amount is usually 750000 ($750,000.00), but it could be higher. It could also be 0 (zero), if BIPD is not required. FMCSA requires companies with contract authority to have BIPD insurance.
48.  FMCSABONDFILED CHAR 1
Possible Values: Y or N. This value indicates whether a broker bond is on file for the company, as reported to the FMCSA by insurance underwriters. There are two possible values: "Y" for yes or "N" for no.
49.  FMCSABONDREQUIRED CHAR 1
Possible Values: Y or N. This value indicates whether the FMCSA requires the company to have a bond. There are two possible values: "Y" for yes or "N" for no. FMCSA requires companies with broker authority to maintain a bond.
50.  FMCSABROKER CHAR 1
This value describes the company's broker authority status. There are three possible values: "A" for active broker authority, "I" for inactive broker authority or "N" for no broker authority.
51.  FMCSABUSADDRESS VARCHAR 50
This is the business address for the company.
52.  FMCSABUSCITY VARCHAR 30
This value is the city for the business address specified in FMCSABUSADDRESS.
53.  FMCSABUSCOUNTRY CHAR 2
This is the 2-character country for the business address specified in FMCSABUSADDRESS. You do not necessary have to display this value.
54.  FMCSABUSFAX VARCHAR 14
This value is the 10-digit business fax number if provided. The value may be NULL. It should be displayed by the business address. Some times there are less than 10 digits. When there are less than 10 digits, you should probably not format the number and identify the problem to the carrier.
55.  FMCSABUSPHONE VARCHAR 14
This value is the 10-digit business phone number if provided. The value may be NULL. It should be displayed by the business address. Some times there are less than 10 digits. When there are less than 10 digits, you should probably not format the number and identify the problem to the carrier.
56.  FMCSABUSSTATE CHAR 2
This value is the 2-character state for the business address specified in FMCSABUSADDRESS.
57.  FMCSABUSZIP VARCHAR 10
This value is the zip code for the business address specified in FMCSABUSADDRESS. Most zip codes are 5 digits. Some are zip plus 4. Others are international postal codes.
58.  FMCSACARGOFILED CHAR 1
This value indicates whether cargo insurance is on file for the company, as reported to the FMCSA by insurance underwriters. There are two possible values: "Y" for yes or "N" for no. Even though cargo insurance may not be required, some companies will maintain a cargo insurance policy.
59.  FMCSACARGOREQUIRED CHAR 1
This value indicates whether the FMCSA requires the company to have cargo insurance. There are two possible values: "Y" for yes or "N" for no. FMCSA requires companies with common authority to have cargo insurance.
60.  FMCSACOMMON CHAR 1
This value describes the company's common carrier authority status. There are three possible values: "A" for active common authority, "I" for inactive common authority or "N" for no common authority.
61.  FMCSACONTRACT CHAR 1
This value describes the company's contract carrier authority status. There are three possible values: "A" for active contract authority, "I" for inactive contract authority or "N" for no contract authority.
62.  FMCSADATELASTUPDATED DATETIME
This the mm/dd/yyyy date that insurance and authority information about the company was last updated in our database.
63.  FMCSADBANAME VARCHAR 60
This is the doing-business-as (dba) name for the company. It should be displayed below the legal name.
64.  FMCSADOCKETNUMBER CHAR 8
This is the motor carrier (MC) number for the company. It may also be an FF or MX number for freight forwarders or Mexican carriers.
65.  FMCSADOTNUMBER NUMERIC 9
This is the USDOT number for the carrier. Values may include 0 or NULL, neither of which should be displayed.
66.  FMCSAFREIGHT CHAR 1
Possible Values: Y or N. This is the "Cargo Authorization" for "Property" Y for Yes and N for No.
67.  FMCSAHOUSEHOLD CHAR 1
Possible Values: Y or N. This is the "Cargo Authorization" for "Household Goods" Y for Yes and N for No.
68.  FMCSALEGALNAME VARCHAR 120
This is the legal name of the company and should be displayed with the business address information.
69.  FMCSAMAILADDRESS VARCHAR 50
This is the optional mailing address for the carrier, in addition to their business address specified in FMCSABUSADDRESS. Some times companies specify a separate mailing address, rather than have mail go to their business address.
70.  FMCSAMAILCITY VARCHAR 30
This value is the city for the mailing address specified in FMCSAMAILADDRESS.
71.  FMCSAMAILCOUNTRY CHAR 2
This is the 2-character country for the mailing address specified in FMCSAMAILADDRESS. You do not necessary have to display this value.
72.  FMCSAMAILFAX VARCHAR 14
This value is the 10-digit mailing address fax number if provided. The value may be NULL. It should be displayed by the mailing address. Some times there are less than 10 digits. When there are less than 10 digits, you should probably not format the number and identify the problem to the carrier.
73.  FMCSAMAILPHONE VARCHAR 14
This value is the 10-digit mailing address phone number if provided. The value may be NULL. It should be displayed by the mailing address. Some times there are less than 10 digits. When there are less than 10 digits, you should probably not format the number and identify the problem to the carrier.
74.  FMCSAMAILSTATE CHAR 2
This value is the 2-character state for the mailing address specified in FMCSAMAILADDRESS.
75.  FMCSAMAILZIP VARCHAR 10
This value is the zip code for the mailing address specified in FMCSAMAILADDRESS. Most zip codes are 5 digits. Some are zip plus 4. Others are international postal codes.
76.  FMCSAPASSENGER CHAR 1
Possible Values: Y or N. This is the "Cargo Authorization" for "Passenger" Y for Yes and N for No.
77.  FMCSAPENDINGBROKER CHAR 1
Possible Values: Y or N. This value describes whether the company has applied for broker authority and is in the process of receiving it. There are two possible values: "Y" for yes or "N" for no.
78.  FMCSAPENDINGCOMMON CHAR 1
Possible Values: Y or N. This value describes whether the company has applied for common carrier authority and is in the process of receiving it. There are two possible values: "Y" for yes or "N" for no.
79.  FMCSAPENDINGCONTRACT CHAR 1
Possible Values: Y or N. This value describes whether the company has applied for contract carrier authority and is in the process of receiving it. There are two possible values: "Y" for yes or "N" for no.
80.  FMCSAREVOKINGBROKER CHAR 1
Possible Values: Y or N. This value describes whether the company is pending revocation of its broker authority. It may soon lose authority. There are two possible values: "Y" for yes or "N" for no. Yes usually indicates the company is within 30 days of the premium being due for its broker bond, and it remains unpaid. However, there are other reasons this warning flag may get raised.
81.  FMCSAREVOKINGCOMMON CHAR 1
Possible Values: Y or N. This value describes whether the company is pending revocation of its common carrier authority. It may soon lose authority. There are two possible values: "Y" for yes or "N" for no. Yes does not mean they have lost their common carrier authority. Yes usually indicates the company is within 30 days of its insurance premium being due, and it remains unpaid. However, there are other reasons this warning flag may get raised.
82.  FMCSAREVOKINGCONTRACT CHAR 1
Possible Values: Y or N. This value describes whether the company is pending revocation of its contract carrier authority. It may soon lose authority. There are two possible values: "Y" for yes or "N" for no. Yes usually indicates the company is within 30 days of its insurance premium being due, and it remains unpaid. However, there are other reasons this warning flag may get raised.
83.  SAFESTATDRSEA REAL 4
NULL value returned. SafeStat scores are no longer available, but the field has been retained for display purposes.
84.  SAFESTATSMSEA REAL 4
NULL value returned. SafeStat scores are no longer available, but the field has been retained for display purposes.
85.  SAFESTATVHSEA REAL 4
NULL value returned. SafeStat scores are no longer available, but the field has been retained for display purposes.
86.  SAFETYRATEDATE DATETIME
Possible Values: NULL or date. If the carrier has a carrier safety rating value specifies in SAFETYRATING, this is the date the safety rating was issued formatted as mm/dd/yyyy. If the carrier has no safety rating, the value will be NULL.
87.  SAFETYRATING CHAR 1
Possible Values: NULL or single letter. This is the carrier safety rating. There are three possible safety ratings: U = Unsatisfactory, C = Conditional, S = Satisfactory. The safety rating was issues on the date specified in SAFETYRATEDATE.
88.  SAFETYREVDATE DATETIME
Possible Values: NULL or date. If the carrier has a safety rating, this is the safety rating "review date" formatted as mm/dd/yyyy. The review date is always earlier than the safety rating date in SAFETYRATEDATE.It is based on the safety review that the carrier is assigned a safety rating. If the carrier has no safety rating, the SAFETYREVDATE value would be NULL because there was no safety review.
89.  SAFETYREVTYPE CHAR 1

Possible Values: NULL or single letter. This is the type of review conducted.


  • C = Compliance Review
  • N = Non-Ratable Review
  • S = Safety Review
  • E = Educational Contact Review
  • U = Historical Audit Record
  • G = Compliance Review and CTFR
  • H = Shipper Review
  • A = Safety Audit
  • B = Automatic Safety Assessment Program Review
  • F = CTFR
  • I = Carrier Inactive
  • J = Compliance Review and Security Contact Review

This code represents a federally conducted or state conducted review of a carrier's/shipper's compliance with the Federal Motor Carrier Safety and Hazardous Material Regulations. These reviews result in the carrier receiving a Federal safety rating of Satisfactory, Unsatisfactory or Conditional.

90.  SMSINSPTOTAL NUMERIC 9
Possible Values: NULL or number. Total number of inspections for the 24-month measurement period.
91.  SMSDRIVINSPTOTAL NUMERIC 9
Possible Values: NULL or number. Number of driver inspections.
92.  SMSDRIVOOSINSPTOTAL NUMERIC 9
Possible Values: NULL or number. Number of driver inspections with at least one driver out-of-service violation.
93.  SMSVEHINSPTOTAL NUMERIC 9
Possible Values: NULL or number. Number of vehicle inspections.
94.  SMSVEHOOSINSPTOTAL NUMERIC 9
Possible Values: NULL or number. Number of vehicle inspections with at least one vehicle out-of-service violation.
95.  SMSCONTRSUBSTBASICALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSCONTRSUBSTPCT score is over the threshold and/or if there are serious violations for controlled substances within the past 12 months. If value is "Y" the carrier has a BASIC alert for the "Controlled Substances / Alcohol" category.
96.  SMSCONTRSUBSTPCT REAL 4
Possible Values: NULL or number. This value is the controlled substances and alcohol BASIC roadside performance percentile (SMS BASIC score for Controlled Substances / Alcohol). Numeric values range from 0 to 100. Scores may have one decimal place, such as 85.4.
97.  SMSCONTRSUBSTRDALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSCONTRSUBSTPCT score is over the threshold.
98.  SMSCONTRSUBSTSV CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the carrier has serious violations from investigation for controlled substances within the past 12 months.
99.  SMSDRIVFITBASICALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSDRIVFITPCT score is over the threshold and/or if there are serious violations for driver fitness within the past 12 months. If value is "Y" the carrier has a BASIC alert for the "Driver Fitness" category.
100.  SMSDRIVFITPCT REAL 4
Possible Values: NULL or number. This value is the driver fitness BASIC roadside performance percentile (SMS BASIC score for Driver Fitness). Numeric values range from 0 to 100. Scores may have one decimal place, such as 85.4.
101.  SMSDRIVFITRDALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSDRIVFITPCT score is over the threshold.
102.  SMSDRIVFITSV CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the carrier has serious violations from investigation for driver fitness within the past 12 months.
103.  SMSFATIGUEDRIVBASICALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSFATIGUEDRIVPCT score is over the threshold and/or if there are serious violations for fatigued driving within the past 12 months. If value is "Y" the carrier has a BASIC alert for the "Fatigued Driving (Hours-of-Service)" category. NOTE: In December 2012 the FMCSA changed the name of the "Fatigued Driving" BASIC category to "Hours of Service (HOS) Compliance". Depsite the FMCSA name change for this category, we left the SMSFATIGUEDRIVBASICALERT name unchanged in our web services.
104.  SMSFATIGUEDRIVPCT REAL 4
Possible Values: NULL or number. This value is the fatigued driving (hours of service) BASIC roadside performance percentile (SMS BASIC score for Fatigued Driving). Numeric values range from 0 to 100. Scores may have one decimal place, such as 85.4. NOTE: In December 2012 the FMCSA changed the name of the "Fatigued Driving" BASIC category to "Hours of Service (HOS) Compliance". Depsite the FMCSA name change for this category, we left the SMSFATIGUEDRIVPCT name unchanged in our web services.
105.  SMSFATIGUEDRIVRDALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSFATIGUEDRIVPCT score is over the threshold. NOTE: In December 2012 the FMCSA changed the name of the "Fatigued Driving" BASIC category to "Hours of Service (HOS) Compliance". Depsite the FMCSA name change for this category, we left the SMSFATIGUEDRIVRDALERT name unchanged in our web services.
106.  SMSFATIGUEDRIVSV CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the carrier has serious violations from investigation for fatigued driving within the past 12 months. NOTE: In December 2012 the FMCSA changed the name of the "Fatigued Driving" BASIC category to "Hours of Service (HOS) Compliance". Depsite the FMCSA name change for this category, we left the SMSFATIGUEDRIVSV name unchanged in our web services.
107.  SMSUNSAFEDRIVBASICALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSUNSAFEDRIVPCT score is over the threshold and/or if there are serious violations for unsafe driving within the past 12 months. If value is "Y" the carrier has a BASIC alert for the "Unsafe Driving" category.
108.  SMSUNSAFEDRIVPCT REAL 4
Possible Values: NULL or number. This value is the unsafe driving BASIC roadside performance percentile (SMS BASIC score for Unsafe Driving). Numeric values range from 0 to 100. Scores may have one decimal place, such as 85.4.
109.  SMSUNSAFEDRIVRDALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSUNSAFEDRIVPCT score is over the threshold.
110.  SMSUNSAFEDRIVSV CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the carrier has serious violations from investigation for unsafe driving within the past 12 months.
111.  SMSVEHMAINTBASICALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSVEHMAINTPCT score is over the threshold and/or if there are serious violations for vehicle maintenance within the past 12 months. If value is "Y" the carrier has a BASIC alert for the "Vehicle Maintenance" category.
112.  SMSVEHMAINTPCT REAL 4
Possible Values: NULL or number. This value is the vehicle maintenance BASIC roadside performance percentile (SMS BASIC score for Vehicle Maintenance). Numeric values range from 0 to 100. Scores may have one decimal place, such as 85.4.
113.  SMSVEHMAINTRDALERT CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the SMSVEHMAINTPCT score is over the threshold.
114.  SMSVEHMAINTSV CHAR 1
Possible Values: "Y" for yes or "N" for no. This value indicates whether the carrier has serious violations from investigation for vehicle maintenance within the past 12 months.