Web Service Integration 32 - CarrierLookup

Introduction
The CarrierLookup web service provides all carrier data SaferWatch has on the carrier.

NOTE: Please do not call CarrierLookup en masse to update your system. See the GetChanges and Watch services to obtain information on larger numbers of carriers. The CarrierLookup service call should be invoked by the user at the point of setting up a new carrier or for getting the latest information prior to assigning a carrier.

Typically, CarrierLookup is called when you are setting up a new carrier to pre-populate your carrier data and/or to get the latest carrier information prior to assigning a carrier to a load

CarrierLookup will return whatever FMCSA information is available on any valid Docket and/or DOT Number regardless of whether or not it is valid interstate carrier. The <carrierType> tag will tell you how SaferWatch has profiled the carrier: Interstate, Interstate and Broker, Broker, Intrastate or Other. <carrierType> is an internal profile label associated with how our system applies Risk Assessment. <carrierType> is not meant to be used as an indicator of what type of business the entity may be licensed for.

Calls on Non Interstate carriers will only return the data that is available and no evaluation will be done on the data. SaferWatch overall risk assessment will always be high on non-interstate carriers in CarrierLookup. For Example, Brokers will likely have no DOT information in which case you would only receive data in the Licensing and Insurance section of the response. For intrastate carriers, you would likely receive only DOT data with no Licensing and Insurance information.

The Web Service Details

https://www.saferwatch.com/webservices/CarrierService32.php
?Action=CarrierLookup
&ServiceKey=YourServiceKey
&CustomerKey=YourCustomerKey
&number=MC, MX, FF or DOT Number (Numbers with no prefix are interpreted as DOT numbers)

Example Carrier Lookup Call:

https://www.saferwatch.com/webservices/CarrierService32.php?Action=CarrierLookup&ServiceKey=DemoServiceKey&CustomerKey=DemoCustomerKey&number=51442
Click to see CarrierLookup results

Response fields values:

<CarrierService32.CarrierLookup>
<ResponseDO> NOTE: See Standard Response
<status>APPROVED</status>
<action>OK</action>
<code>SFW00389</code>
<displayMsg></displayMsg>
<techMsg></techMsg>
</ResponseDO>
<CarrierDetails>
<docketNumber>MC, FF or MX Number</docketNumber>
<dotNumber status="ACTIVE or INACTIVE">DOT Integer Value</dotNumber>
<carrierType>Interstate, Interstate/Broker, Broker, Intrastate, or Other</carrierType>
<Identity>
<legalName>Company Legal Name</legalName>
<dbaName>Company doing business as (DBA) Name</dbaName>
<businessStreet>Business address line</businessStreet>
<businessCity>Business City</businessCity>
<businessState>2 Char Business State</businessState>
<businessZipCode>Business Zip Code</businessZipCode>
<businessColonia>Mexican Carrier Colonia</businessColonia>
<businessCountry>2 char country code</businessCountry>
<businessPhone>phone format XXX-XXX-XXXX</businessPhone>
<businessFax>phone format XXX-XXX-XXXX</businessFax>
<mailingStreet>Mailing Address</mailingStreet>
<mailingCity>Mailing City</mailingCity>
<mailingState>2 char mailing state code</mailingState>
<mailingZipCode>mailing zip code</mailingZipCode>
<mailingColonia>Mexican Carrier Colonia</mailingColonia>
<mailingCountry>Mailing country code</mailingCountry>
<mailingPhone>phone format XXX-XXX-XXXX</mailingPhone>
<mailingFax>phone format XXX-XXX-XXXX</mailingFax>
<undeliverableMail>Yes or No if mail was returned as undeliverable</undeliverableMail>
<companyRep1>LINDAContact name 1</companyRep1>
<companyRep2>Contact name 2</companyRep2>
<cellPhone>phone format XXX-XXX-XXXX</cellPhone>
<emailAddress>Contact email address</emailAddress>
<dunBradstreetNum>Dun&Bradstreet Number</dunBradstreetNum>
<organization>Empty, Corporation, Individual, or Partnership</organization>
</Identity>
<Authority>
<authGrantDate>Date format YYYY-MM-DD of when authority was granted</authGrantDate>
<commonAuthority>Active, InActive or None</commonAuthority>
<commonAuthorityPending>Yes or No</commonAuthorityPending>
<commonAuthorityRevocation>Yes or No</commonAuthorityRevocation>
<contractAuthority>Active, InActive or None</contractAuthority>
<contractAuthorityPending>Yes or No</contractAuthorityPending>
<contractAuthorityRevocation>Yes or No</contractAuthorityRevocation>
<brokerAuthority>Active, InActive or None</brokerAuthority>
<brokerAuthorityPending>Yes or No</brokerAuthorityPending>
<brokerAuthorityRevocation>Yes or No</brokerAuthorityRevocation>
<freight>Yes or No if authorized for freight</freight>
<passenger>Yes or No if authorized for passenger</passenger>
<householdGoods>Yes or No if authorized for householdGoods</householdGoods>
<private>Yes or No if authorized as private</private>
<enterprise>Yes or No if authorized for enterprise</enterprise>
</Authority>
<FMCSAInsurance>
<bipdRequired>Bodily Injury & Property Damage (BIPD) required amount</bipdRequired>
<bipdOnFile>Bodily Injury & Property Damage (BIPD) on file amount</bipdOnFile>
<cargoRequired>Yes or No if Cargo Insurance is required</cargoRequired>
<cargoOnFile>Yes or No if Cargo Insurance is on file</cargoOnFile>
<bondSuretyRequired>Yes or No if Bond Sureity is required</bondSuretyRequired>
<bondSuretyOnFile>Yes or No if Bond Sureity is on file</bondSuretyOnFile>
<PolicyList>
<PolicyItem> Note: Will be PolicyItems for each policy on file.
<companyName>Insurance company name</companyName>
<attnToName>Insruance contact name</attnToName>
<address>Insurance company address</address>
<city>Insurance company city</city>
<stateCode>Insurance company 2 char state code</stateCode>
<postalCode>Insurance company zip code</postalCode>
<countryCode>Insurance company country code</countryCode>
<phone>Insurance company phone format XXX-XXX-XXXX</phone>
<fax>Insurance company fax format XXX-XXX-XXXX</fax>
<insuranceType>BIPD, BIPD Excess, Cargo, Surety or Trust Fund</insuranceType>
<policyNumber>Policy Number</policyNumber>
<postedDate>Date Policy posted</postedDate>
<effectiveDate>Date insurance is effective format YYYY-DD-MM</effectiveDate>
<cancelationDate>Date Policy Cancels</cancelationDate>
<coverageFrom>Underlying limit of the coverage</coverageFrom>
<coverageTo>Maximum limit of the coverage</coverageTo>
<amBestRating>Insurance company Rating provided by AMBest</amBestRating>
</PolicyItem>
</PolicyList>
</FMCSAInsurance>
<CertData status="ACCOUNTEXPIRED, UNQUALIFIEDCARRIER, NOTONFILE, NONCOOP or OK">
<NonCoopReason>The Reason if give why noncoop</NonCoopReason>
<Certificate> Note: Multiple Certificates may exist
<certificateID>Unique ID for this certificate. Used to aquire image</certificateID>
<producerName>Insurance Producer Name</producerName>
<producerAddress>Insurance Producer Address</producerAddress>
<producerCity>Insurance Producer City</producerCity>
<producerState>Insurance Producer State</producerState>
<producerZip>Insurance Producer Zip Code</producerZip>
<producerPhone>Insurance Producer Phone</producerPhone>
<producerFax>Insurance Producer Fax</producerFax>
<producerEmail>Insurance Producer Email</producerEmail>
<paidFor>Yes or No depending if customer paid for the certificate</paidFor>
<Coverage> NOTE: Mulitple coverages may exist for the certificate
<insurerName>Insurance company name</insurerName>
<type>Cargo Liability w/ Reefer Breakdown,Cargo,Auto,General, or WorkersCompensation</type>
<policyNumber>Policy Number</policyNumber>
<expirationDate>Expiration date YYYY-MM-DD</expirationDate>
<coverageLimit>Coverage limit amount</coverageLimit>
<deductable>Coverage deductable amount</deductable>
<reeferBreakdown>Yes or No if reefer breakdown included in coverage</reeferBreakdown>
<reeferBreakDeduct>Deductable amount if reefer breakdown included in coverage</reeferBreakDeduct>
</Coverage>
</Certificate>
</CertData>
<Safety>
<rating>Satisfactory, Not Rated, Conditional or Unsatisfactory</rating>
<ratingDate>rating date format YYYY-MM-DD</ratingDate>
<unsafeDrvPCT>CSA Percent format #.#</unsafeDrvPCT>
<unsafeDrvOT>Yes or No if over threshold</unsafeDrvOT>
<unsafeDrvSV>Yes or No if severe violoation</unsafeDrvSV>
<unsafeDrvAlert>Yes or No if overall basic alert triggered</unsafeDrvAlert>
<unsafeDrvTrend>UP, DOWN or NA if not applicable</unsafeDrvTrend>
<hosPCT>CSA Percent format #.#</hosPCT>
<hosOT>Yes or No if over threshold</hosOT>
<hosSV>Yes or No if severe violoation</hosSV>
<hosAlert>Yes or No if overall basic alert triggered</hosAlert>
<hosTrend>UP, DOWN or NA if not applicable</hosTrend>
<drvFitPCT>CSA Percent format #.#</drvFitPCT>
<drvFitOT>Yes or No if over threshold</drvFitOT>
<drvFitSV>Yes or No if severe violoation</drvFitSV>
<drvFitAlert>Yes or No if overall basic alert triggered</drvFitAlert>
<drvFitTrend>UP, DOWN or NA if not applicable</drvFitTrend>
<controlSubPCT>CSA Percent format #.#</controlSubPCT>
<controlSubOT>Yes or No if over threshold</controlSubOT>
<controlSubSV>Yes or No if severe violoation</controlSubSV>
<controlSubAlert>Yes or No if overall basic alert triggered</controlSubAlert>
<controlSubTrend>UP, DOWN or NA if not applicable</controlSubTrend>
<vehMaintPCT>CSA Percent format #.#</vehMaintPCT>
<vehMaintOT>Yes or No if over threshold</vehMaintOT>
<vehMaintSV>Yes or No if severe violoation</vehMaintSV>
<vehMaintAlert>Yes or No if overall basic alert triggered</vehMaintAlert>
<vehMaintTrend>UP, DOWN or NA if not applicable</vehMaintTrend>
</Safety>
<Inspection>
<inspectVehUS>US Vehicle inspection count</inspectVehUS>
<inspectVehOOSUS>US Vehicle inspections out of service</inspectVehOOSUS>
<inspectVehOOSPctUS>US Vehicle inspection out of service percent</inspectVehOOSPctUS>
<inspectDrvUS>US Driver inspection count</inspectDrvUS>
<inspectDrvOOSUS>US Driver inspection out of service count</inspectDrvOOSUS>
<inspectDrvOOSPctUS>tUS Driver inspection out of service percent</inspectDrvOOSPctUS>
<inspectHazUS>US Hazardous inspection count</inspectHazUS>
<inspectHazOOSUS>US Hazardous inspection out of service count</inspectHazOOSUS>
<inspectHazOOSPctUS>tUS Hazardous inspection out of service percent</inspectHazOOSPctUS>
<inspectIEPUS>US Intermodal inspection count</inspectIEPUS>
<inspectIEPOOSUS>US Intermodal inspection out of service count</inspectIEPOOSUS>
<inspectIEPOOSPctUS>tUS Intermodal inspection out of service percent</inspectIEPOOSPctUS>
<inspectTotalIEPUS>US Total Intermodal inspections</inspectTotalIEPUS>
<inspectTotalUS>US Total inspection count</inspectTotalUS>
<inspectVehCAN>Canadian Vehicle inspection count</inspectVehCAN>
<inspectVehOOSCAN>gtCanadian Vehicle inspections out of service</inspectVehOOSCAN>
<inspectVehOOSPctCAN>gtCanadian Vehicle inspections out of service percent</inspectVehOOSPctCAN>
<inspectDrvCAN>gtCanadian Driver inspections count</inspectDrvCAN>
<inspectDrvOOSCAN>Canadian Driver inspections out of service</inspectDrvOOSCAN>
<inspectDrvOOSPctCAN>Canadian Driver inspections out of service percent</inspectDrvOOSPctCAN>
<inspectTotalCAN>Canadian Total inspections count</inspectTotalCAN>
</Inspection>
<Crash>
<crashFatalUS>0</crashFatalUS>
<crashInjuryUS>0</crashInjuryUS>
<crashTowUS>0</crashTowUS>
<crashTotalUS>0</crashTotalUS>
<crashFatalCAN>0</crashFatalCAN>
<crashInjuryCAN>0</crashInjuryCAN>
<crashTowCAN>0</crashTowCAN>
<crashTotalCAN>0</crashTotalCAN>
</Crash>
<Review>
<reviewType>
Empty,
Compliance,
CR and CTFR,
CR and Security Contact Review,
Educational Contact Review,
Historical Audit,
Non-Rateable, or
Safety Review
</reviewType>
<reviewDate>Date of review format YYYY-MM-DD</reviewDate>
<reviewDocNum>Review document number</reviewDocNum>
<reviewMiles>Miles reported on last review</reviewMiles>
<mcs150Date>MCS150 last update date format YYYY-MM-DD</mcs150Date>
<mcs150MileYear>MCS150 mileage year</mcs150MileYear>
<mcs150Miles>MCS150 reported miles</mcs150Miles>
<accidentRate>Accident Rate percent</accidentRate>
<accidentRatePrevent>Accident Rate Prevent percent</accidentRatePrevent>
</Review>
<Operation>
<dotAddDate>Date the DOT record was added YYYY-MM-DD</dotAddDate>
<carrierOperation>Interstate, Intrastate, Intrastate Hazmat, or None</carrierOperation>
<shipperOperation>Interstate, Intrastate or None</shipperOperation>
<mxOperationType>Empty, OP-1 or OP-2</mxOperationType>
<mxRFCNumber>Mexican Carrier registration number</mxRFCNumber>
<outOfService>Yes or No if out of service</outOfService>
<outOfServiceDate>Out of service date YYYY-MM-DD</outOfServiceDate>
<outOfServiceReason>Out of service reason</outOfServiceReason>
<entityCarrier>Yes or No</entityCarrier>
<entityShipper>Yes or No</entityShipper>
<entityBroker>Yes or No</entityBroker>
<entityFreightFowarder>Yes or No</entityFreightFowarder>
<entityCargoTank>Yes or No</entityCargoTank>
<classAuthForHire>Yes or No</classAuthForHire>
<classMigrant>Yes or No</classMigrant>
<classIndianNation>Yes or No</classIndianNation>
<classExemptForHire>Yes or No</classExemptForHire>
<classUSMail>Yes or No</classUSMail>
<classPrivateProperty>Yes or No</classPrivateProperty>
<classFederalGovernment>Yes or No</classFederalGovernment>
<classPrivPassBusiness>Yes or No</classPrivPassBusiness>
<classStateGovernment>Yes or No</classStateGovernment>
<classPrivPassNonBusiness>Yes or No</classPrivPassNonBusiness>
<classLocalGovernment>Yes or No</classLocalGovernment>
<classOther>
</classOther>
</operatingStatus>
</Operation>
<Cargo>
<hazmatIndicator>Yes or No</hazmatIndicator>
<cargoGenFreight>Yes or No</cargoGenFreight>
<cargoHousehold>Yes or No</cargoHousehold>
<cargoMetal>Yes or No</cargoMetal>
<cargoMotorVeh>Yes or No</cargoMotorVeh>
<cargoDriveTow>Yes or No</cargoDriveTow>
<cargoLogPole>Yes or No</cargoLogPole>
<cargoBldgMaterial>Yes or No</cargoBldgMaterial>
<cargoMobileHome>Yes or No</cargoMobileHome>
<cargoMachLarge>Yes or No</cargoMachLarge>
<cargoProduce>Yes or No</cargoProduce>
<cargoLiqGas>Yes or No</cargoLiqGas>
<cargoIntermodal>Yes or No</cargoIntermodal>
<cargoPassengers>Yes or No</cargoPassengers>
<cargoOilfield>Yes or No</cargoOilfield>
<cargoLivestock>Yes or No</cargoLivestock>
<cargoGrainfeed>Yes or No</cargoGrainfeed>
<cargoCoalcoke>Yes or No</cargoCoalcoke>
<cargoMeat>Yes or No</cargoMeat>
<cargoGarbage>Yes or No</cargoGarbage>
<cargoUSMail>Yes or No</cargoUSMail>
<cargoChemicals>Yes or No</cargoChemicals>
<cargoDryBulk>Yes or No</cargoDryBulk>
<cargoRefrigerated>Yes or No</cargoRefrigerated>
<cargoBeverages>Yes or No</cargoBeverages>
<cargoPaperProd>Yes or No</cargoPaperProd>
<cargoUtilities>Yes or No</cargoUtilities>
<cargoFarmSupplies>Yes or No</cargoFarmSupplies>
<cargoConstruction>Yes or No</cargoConstruction>
<cargoWaterwell>Yes or No</cargoWaterwell>
<cargoOther>Yes or No</cargoOther>
<cargoOtherDesc>
</cargoOtherDesc>
</Cargo>
<Drivers>
<driversTotal>Total driver account</driversTotal>
<driversAvgLeased>Leased driver count</driversAvgLeased>
<driversCDL>CDL driver count</driversCDL>
<driversInter>Interstate driver count</driversInter>
<driversInterLT100>Interstate drivers less than 100 miles</driversInterLT100>
<driversInterGT100>Interstate drivers greater than 100 miles</driversInterGT100>
<driversIntra>Intrastate driver count</driversIntra>
<driversIntraLT100>Intrastate drivers less than 100 miles</driversIntraLT100>
<driversIntraGT100>Intrastate drivers greater than 100 miles</driversIntraGT100>
</Drivers>
<Equipment>
<trucksTotal>Total Trucks</trucksTotal>
<totalPower>Total Power Units</totalPower>
<fleetsize>Fleet size range</fleetsize>
<trucksOwned>Trucks Owned</trucksOwned>
<trucksTerm>Trucks Term Leased</trucksTerm>
<trucksTrip>Trucks Trip Leased</trucksTrip>
<trailersOwned>Trailers Owned</trailersOwned>
<trailersTerm>Trailers Term Leased</trailersTerm>
<trailersTrip>Trailers Trip Leased</trailersTrip>
<tractorsOwned>Tracktores Owned</tractorsOwned>
<tractorsTerm>Tractors Term Leased</tractorsTerm>
<tractorsTrip>Tractors Trip Leased</tractorsTrip>
</Equipment>
<Other>
<carbTru>0</carbTru>
<smartway>1</smartway>
<watchdogReports>NOACCOUNT, Yes or No</watchdogReports>
</Other>
<RiskAssessment>
<Overall>Acceptable, Moderate or Unacceptable</Overall>
<Authority>Acceptable, Moderate or Unacceptable</Authority>
<Insurance>Acceptable, Moderate or Unacceptable</Insurance>
<Safety>Acceptable, Moderate or Unacceptable</Safety>
<Operation>Acceptable, Moderate or Unacceptable</Operation>
<Other>Acceptable, Moderate or Unacceptable</Other>
</RiskAssessment>
</CarrierDetails>
</CarrierService32.CarrierLookup>