Search for trucks

POST /V13/Searching/TruckSearch.svc Gets the details for a specified truck based on critiria.

Authorization Username, Password, & Integration ID
SOAP Action http://webservices.truckstop.com/v12/ITruckSearch/GetTruckSearchResults
Content Type text/xml
Accept text/xml
URL Params None
Body Params XML data

📘

Truck Search

Input

GetTruckSearchResultsRequest

Requirements

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

Truck Search also requires TruckSearchCriteria

  • Origin and Destination specified as a {State}, {City and State}, {City, State, and Country}, or {latitude and longitude} in integer format. Example:
  • EquipmentType – A comma-delimited list specifying between 1 to 3 different equipment-types. See Supported Equipment Types below for the recognized tags. See list of Supported Equipment Types
  • Age - Enter 0 to return all results, otherwise enter the age of the load (in hours) to filter by.
  • PageSize - between 1-200.
  • EquipmentOptions - Optional - See list of enum EquipmentOptions
  • LoadType - Optional - See list of enum LoadTypes

Notes:

  • Origin and Destination City/State spelling will be validated and, if possible, auto-corrected before submitting requests. Invalid Origin or Destination will be rejected with an error message which includes suggestions for valid spellings.
    • See Supported Countries for valid OriginCountry and DestinationCountry values
    • See Supported States and Provinces for supported states and provinces values.).
  • To search for Trucks based on Age, specify the age in hours in the ‘HoursOld’ field. If filtering based on Age is not required, specify a 0 in the ‘HoursOld’ field.

Output

TruckSearchReturn

Sample Request

curl --location 'https://testws.truckstop.com/V13/Searching/TruckSearch.svc' \
--header 'Content-Type: text/xml' \
--header 'SOAPAction: http://webservices.truckstop.com/v12/ITruckSearch/GetTruckSearchResults' \
--header 'Cookie: ASP.NET_SessionId=fqfh5kbcneyitjndt1mevw3f' \
--data '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v12="http://webservices.truckstop.com/v12" xmlns:web="http://schemas.datacontract.org/2004/07/WebServices" xmlns:web1="http://schemas.datacontract.org/2004/07/WebServices.Objects" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:truc="http://schemas.datacontract.org/2004/07/Truckstop2.Objects">
   <soapenv:Header/>
   <soapenv:Body>
      <v12:GetTruckSearchResults>
         <v12:searchRequest>
            <web:IntegrationId>######</web:IntegrationId>
            <web:Password>Passw0rd</web:Password>
            <web:UserName>USERNAME</web:UserName>
            <web1:Criteria>
               <web1:DatesAvailable>
                  <!--Zero or more repetitions:-->
                  <arr:dateTime>2024-09-17T14:07:42.768Z</arr:dateTime>
               </web1:DatesAvailable>
               <!--Optional:-->
               <web1:DestinationCity>New York</web1:DestinationCity>
               <!--Optional:-->
               <web1:DestinationCountry>USA</web1:DestinationCountry>
							 <!--Optional:-->
               <web1:DestinationRange>300</web1:DestinationRange>
               <!--Optional:-->
               <web1:DestinationState>NY</web1:DestinationState>
               <web1:EquipmentOptions>
                  <!--Zero or more repetitions:-->
                  <truc:TrailerOptionType></truc:TrailerOptionType>-->
               </web1:EquipmentOptions>
               <!--Optional:-->
               <web1:EquipmentType>V</web1:EquipmentType>
               <web1:HoursOld>0</web1:HoursOld>
               <web1:LoadType>All</web1:LoadType>
               <web1:OriginCity>Chicago</web1:OriginCity>
               <web1:OriginCountry>USA</web1:OriginCountry>
               <web1:OriginRange>300</web1:OriginRange>
               <web1:OriginState>IL</web1:OriginState>
               <web1:PageNumber>0</web1:PageNumber>
               <web1:PageSize<5</web1:PageSize>
               <web1:SortBy>Age</web1:SortBy>
               <web1:SortDescending>false</web1:SortDescending>
            </web1:Criteria>
         </v12:searchRequest>
      </v12:GetTruckSearchResults>
   </soapenv:Body>
</soapenv:Envelope>'
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <GetTruckSearchResultsResponse xmlns="http://webservices.truckstop.com/v12">
            <GetTruckSearchResultsResult 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:TruckSearchResult>
                        <a:Age>9+</a:Age>
                        <a:CPRRating/>
                        <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID>
                        <a:CompanyName>Trimble</a:CompanyName>
                        <a:DateAvailable>6/2/24</a:DateAvailable>
                        <a:DesiredDestination/>
                        <a:DestinationCity/>
                        <a:DestinationCountry>USA</a:DestinationCountry>
                        <a:DestinationDistance>0</a:DestinationDistance>
                        <a:DestinationState/>
                        <a:Entered>2024-10-18T10:08:15.7</a:Entered>
                        <a:Equipment>V</a:Equipment>
                        <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/>
                        <a:FileCheck>false</a:FileCheck>
                        <a:HasCarbData/>
                        <a:HomeBaseState>NJ</a:HomeBaseState>
                        <a:Id>66290530</a:Id>
                        <a:IsFriend>false</a:IsFriend>
                        <a:Length/>
                        <a:LoadType>Partial</a:LoadType>
                        <a:MinimumMiles>0</a:MinimumMiles>
                        <a:OriginCity>chicago</a:OriginCity>
                        <a:OriginCountry>USA</a:OriginCountry>
                        <a:OriginDistance>0</a:OriginDistance>
                        <a:OriginState>il</a:OriginState>
                        <a:PointOfContactPhone>609-252-8177</a:PointOfContactPhone>
                        <a:RatePerMile>3.0000</a:RatePerMile>
                        <a:TruckCompanyId>424412</a:TruckCompanyId>
                        <a:Weight>0</a:Weight>
                        <a:Width>1.00</a:Width>
                    </a:TruckSearchResult>
                    <a:TruckSearchResult>
                        <a:Age>9+</a:Age>
                        <a:CPRRating/>
                        <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID>
                        <a:CompanyName>Trimble</a:CompanyName>
                        <a:DateAvailable>6/2/24</a:DateAvailable>
                        <a:DesiredDestination/>
                        <a:DestinationCity/>
                        <a:DestinationCountry>USA</a:DestinationCountry>
                        <a:DestinationDistance>0</a:DestinationDistance>
                        <a:DestinationState/>
                        <a:Entered>2024-10-18T10:08:15.7</a:Entered>
                        <a:Equipment>V</a:Equipment>
                        <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/>
                        <a:FileCheck>false</a:FileCheck>
                        <a:HasCarbData/>
                        <a:HomeBaseState>NJ</a:HomeBaseState>
                        <a:Id>66290531</a:Id>
                        <a:IsFriend>false</a:IsFriend>
                        <a:Length/>
                        <a:LoadType>Partial</a:LoadType>
                        <a:MinimumMiles>0</a:MinimumMiles>
                        <a:OriginCity>chicago</a:OriginCity>
                        <a:OriginCountry>USA</a:OriginCountry>
                        <a:OriginDistance>0</a:OriginDistance>
                        <a:OriginState>il</a:OriginState>
                        <a:PointOfContactPhone>609-252-8177</a:PointOfContactPhone>
                        <a:RatePerMile>3.0000</a:RatePerMile>
                        <a:TruckCompanyId>424412</a:TruckCompanyId>
                        <a:Weight>0</a:Weight>
                        <a:Width>1.00</a:Width>
                    </a:TruckSearchResult>
                    <a:TruckSearchResult>
                        <a:Age>9+</a:Age>
                        <a:CPRRating/>
                        <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID>
                        <a:CompanyName>Mike R T</a:CompanyName>
                        <a:DateAvailable>3/10/24</a:DateAvailable>
                        <a:DesiredDestination>Vincentown, nj</a:DesiredDestination>
                        <a:DestinationCity>Vincentown</a:DestinationCity>
                        <a:DestinationCountry>USA</a:DestinationCountry>
                        <a:DestinationDistance>72</a:DestinationDistance>
                        <a:DestinationState>nj</a:DestinationState>
                        <a:Entered>2024-03-08T11:22:17.54</a:Entered>
                        <a:Equipment>V</a:Equipment>
                        <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/>
                        <a:FileCheck>false</a:FileCheck>
                        <a:HasCarbData/>
                        <a:HomeBaseState>mi</a:HomeBaseState>
                        <a:Id>66276055</a:Id>
                        <a:IsFriend>false</a:IsFriend>
                        <a:Length/>
                        <a:LoadType>Partial</a:LoadType>
                        <a:MinimumMiles>0</a:MinimumMiles>
                        <a:OriginCity>Bridgman</a:OriginCity>
                        <a:OriginCountry>USA</a:OriginCountry>
                        <a:OriginDistance>58</a:OriginDistance>
                        <a:OriginState>mi</a:OriginState>
                        <a:PointOfContactPhone>333-444-5556</a:PointOfContactPhone>
                        <a:RatePerMile>3.0000</a:RatePerMile>
                        <a:TruckCompanyId>424943</a:TruckCompanyId>
                        <a:Weight>0</a:Weight>
                        <a:Width>1.00</a:Width>
                    </a:TruckSearchResult>
                    <a:TruckSearchResult>
                        <a:Age>9+</a:Age>
                        <a:CPRRating/>
                        <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID>
                        <a:CompanyName>ITS Inte</a:CompanyName>
                        <a:DateAvailable>9/21/22</a:DateAvailable>
                        <a:DesiredDestination>New York, NY</a:DesiredDestination>
                        <a:DestinationCity>New York</a:DestinationCity>
                        <a:DestinationCountry>USA</a:DestinationCountry>
                        <a:DestinationDistance>0</a:DestinationDistance>
                        <a:DestinationState>NY</a:DestinationState>
                        <a:Entered>2023-04-27T21:14:15.913</a:Entered>
                        <a:Equipment>VF</a:Equipment>
                        <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/>
                        <a:FileCheck>false</a:FileCheck>
                        <a:HasCarbData/>
                        <a:HomeBaseState>ID</a:HomeBaseState>
                        <a:Id>66061775</a:Id>
                        <a:IsFriend>false</a:IsFriend>
                        <a:Length/>
                        <a:LoadType>Full</a:LoadType>
                        <a:MinimumMiles>0</a:MinimumMiles>
                        <a:OriginCity>Chicago</a:OriginCity>
                        <a:OriginCountry>USA</a:OriginCountry>
                        <a:OriginDistance>0</a:OriginDistance>
                        <a:OriginState>IL</a:OriginState>
                        <a:PointOfContactPhone>333-444-5556</a:PointOfContactPhone>
                        <a:RatePerMile>0.0000</a:RatePerMile>
                        <a:TruckCompanyId>424921</a:TruckCompanyId>
                        <a:Weight>0</a:Weight>
                        <a:Width>0.00</a:Width>
                    </a:TruckSearchResult>
                    <a:TruckSearchResult>
                        <a:Age>9+</a:Age>
                        <a:CPRRating/>
                        <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID>
                        <a:CompanyName>ITS Inte</a:CompanyName>
                        <a:DateAvailable>9/20/22</a:DateAvailable>
                        <a:DesiredDestination>New York, NY</a:DesiredDestination>
                        <a:DestinationCity>New York</a:DestinationCity>
                        <a:DestinationCountry>USA</a:DestinationCountry>
                        <a:DestinationDistance>0</a:DestinationDistance>
                        <a:DestinationState>NY</a:DestinationState>
                        <a:Entered>2023-04-27T21:14:15.913</a:Entered>
                        <a:Equipment>VF</a:Equipment>
                        <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/>
                        <a:FileCheck>false</a:FileCheck>
                        <a:HasCarbData/>
                        <a:HomeBaseState>ID</a:HomeBaseState>
                        <a:Id>66061776</a:Id>
                        <a:IsFriend>false</a:IsFriend>
                        <a:Length/>
                        <a:LoadType>Full</a:LoadType>
                        <a:MinimumMiles>0</a:MinimumMiles>
                        <a:OriginCity>Chicago</a:OriginCity>
                        <a:OriginCountry>USA</a:OriginCountry>
                        <a:OriginDistance>0</a:OriginDistance>
                        <a:OriginState>IL</a:OriginState>
                        <a:PointOfContactPhone>333-444-5556</a:PointOfContactPhone>
                        <a:RatePerMile>0.0000</a:RatePerMile>
                        <a:TruckCompanyId>424921</a:TruckCompanyId>
                        <a:Weight>0</a:Weight>
                        <a:Width>0.00</a:Width>
                    </a:TruckSearchResult>
                </a:SearchResults>
            </GetTruckSearchResultsResult>
        </GetTruckSearchResultsResponse>
    </s:Body>
</s:Envelope>