Search for hidden capacity (Hot Prospects)

POST	/v13/Searching/HotProspectSearch.svc	Searches for carriers actively looking for loads based on search criteria.
Authorization	Username, Password, & Integration ID
SOAP Action	http://webservices.truckstop.com/v9/IHotProspectSearch/GetSearchResults
Content Type	text/xml
Accept	text/xml
URL Params	None
Body Params	XML data

📘

Hot Prospects

Input

HotProspectSearchRequest

Requirements

Authentication requires an account with a valid user name, password, and integration ID that has Hot Prospects Web Service enabled.

Output

HotProspectSearchReturn

Sample Request/Response

Request

curl --location 'https://testws.truckstop.com/v13/Searching/HotProspectSearch.svc' \
--header 'SOAPAction: http://webservices.truckstop.com/v9/IHotProspectSearch/GetSearchResults' \
--header 'Content-Type: text/xml' \
--data '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v9="http://webservices.truckstop.com/v9" xmlns:web="http://schemas.datacontract.org/2004/07/WebServices" xmlns:web1="http://schemas.datacontract.org/2004/07/WebServices.Objects">
   <soapenv:Header/>
   <soapenv:Body>
      <v9:GetSearchResults>
         <v9:searchRequest>
             <web:IntegrationId>12345</web:IntegrationId>
            <web:Password>MyPass123!</web:Password>
            <web:UserName>MyWSUsername</web:UserName>
            <web1:Criteria>
               <!--Optional:-->
               <web1:DestinationCity>Chicago</web1:DestinationCity>
               <!--Optional:-->
               <web1:DestinationCountry>USA</web1:DestinationCountry>
               <!--Optional:-->
               <web1:DestinationMultipleState>false</web1:DestinationMultipleState>
               <!--Optional:-->
               <web1:DestinationRange>100</web1:DestinationRange>
               <!--Optional:-->
               <web1:DestinationState>IL</web1:DestinationState>
               <!--Optional:-->
               <web1:EquipmentOptions></web1:EquipmentOptions>
               <web1:EquipmentType>F</web1:EquipmentType>
               <web1:MinutesOld>0</web1:MinutesOld>
               <web1:OriginCity>Boise</web1:OriginCity>
               <web1:OriginCountry>USA</web1:OriginCountry>
               <web1:OriginMultipleState>false</web1:OriginMultipleState>
               <web1:OriginRange>100</web1:OriginRange>
               <web1:OriginState>ID</web1:OriginState>
            </web1:Criteria>
         </v9:searchRequest>
      </v9:GetSearchResults>
   </soapenv:Body>
</soapenv:Envelope>'

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <GetSearchResultsResponse xmlns="http://webservices.truckstop.com/v9">
            <GetSearchResultsResult xmlns:a="http://schemas.datacontract.org/2004/07/WebServices.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <Errors xmlns="http://schemas.datacontract.org/2004/07/WebServices"/>
                <a:SearchResults>
                    <a:HotProspectSearchResult>
                        <a:Age>3</a:Age>
                        <a:CPRRating>B</a:CPRRating>
                        <a:CacciCompanyID>3bf6a1a2-f6f1-bca8-7e32-65c3c3728eab</a:CacciCompanyID>
                        <a:CompanyId>803628</a:CompanyId>
                        <a:CompanyName>ANTHONY </a:CompanyName>
                        <a:DOTNumber>4120303</a:DOTNumber>
                        <a:DestinationCity/>
                        <a:DestinationState/>
                        <a:DispatchPhone>559-341-1668</a:DispatchPhone>
                        <a:Equipment>F</a:Equipment>
                        <a:EquipmentOptions/>
                        <a:HandleName>ANTHONY</a:HandleName>
                        <a:HasCarbData>false</a:HasCarbData>
                        <a:MCNumber/>
                        <a:OriginCity>ONTARIO</a:OriginCity>
                        <a:OriginDistance>47</a:OriginDistance>
                        <a:OriginState>OR</a:OriginState>
                        <a:TMCNumber>1575728</a:TMCNumber>
                    </a:HotProspectSearchResult>
                    <a:HotProspectSearchResult>
                        <a:Age>3</a:Age>
                        <a:CPRRating>A</a:CPRRating>
                        <a:CacciCompanyID>a6690433-2c82-29f0-fc0b-4ea836aa6780</a:CacciCompanyID>
                        <a:CompanyId>655376</a:CompanyId>
                        <a:CompanyName>Clark Ir</a:CompanyName>
                        <a:DOTNumber>679675</a:DOTNumber>
                        <a:DestinationCity/>
                        <a:DestinationState/>
                        <a:DispatchPhone>208-740-9004</a:DispatchPhone>
                        <a:Equipment>ANY</a:Equipment>
                        <a:EquipmentOptions/>
                        <a:HandleName>Clark</a:HandleName>
                        <a:HasCarbData>false</a:HasCarbData>
                        <a:MCNumber/>
                        <a:OriginCity>PARMA</a:OriginCity>
                        <a:OriginDistance>38</a:OriginDistance>
                        <a:OriginState>ID</a:OriginState>
                        <a:TMCNumber>470083</a:TMCNumber>
                    </a:HotProspectSearchResult>                    
                </a:SearchResults>
            </GetSearchResultsResult>
        </GetSearchResultsResponse>
    </s:Body>
</s:Envelope>