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
RequirementsAuthentication 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
Sample Requestcurl --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>