Truck Searching Web Service Requests
| POST | /V13/Searching/TruckSearch.svc | Gets the details for multiple trucks based on search criteria. |
|---|---|---|
| Authorization | Username, Password, & Integration ID | |
| SOAP Action | http://webservices.truckstop.com/v12/ITruckSearch/GetMultipleTruckDetailResults | |
| Content Type | text/xml | |
| Accept | text/xml | |
| URL Params | None | |
| Body Params | XML data | |
## Get Multiple Truck Details Results
InputGetMultipleTruckDetailResultsRequest
RequirementsAuthentication requires an account with a valid user name, password, and integration id that has Truck Search Web Service enabled.
GetMultipleTruckDetailsResults also requires TruckSearchCriteria
- A single state or multiple states are acceptable with a maximum of 15 states for both Origin and Destination.
- Origin and Destination specified as a {State}, {City and State}, {City, State, and Country}, or {latitude and longitude} in integer format.
- For multi-state searches, enter a comma-delimited list of state abbreviations in the State field.
- 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/GetMultipleTruckDetailResults' \ --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:GetMultipleTruckDetailResults> <v12:searchRequest> <web:IntegrationId>12345</web:IntegrationId> <web:Password>MyPass123!</web:Password> <web:UserName>MyWSUsername</web:UserName> <web1:Criteria> <web1:DatesAvailable> <!-- Zero or more iterations:--> <arr:dateTime>2024-11-11T00:00:00Z</arr:dateTime> </web1:DatesAvailable> <!--Optional:--> <web1:DestinationCity>New York</web1:DestinationCity> <!--Optional:--> <web1:DestinationCountry>USA</web1:DestinationCountry> <!--Optional:--> <web1:DestinationRange>150</web1:DestinationRange> <!--Optional:--> <web1:DestinationState>NY</web1:DestinationState> <web1:EquipmentOptions> <!-- Zero or more iterations:--> <truc:TrailerOptionType>Team</truc:TrailerOptionType> </web1:EquipmentOptions> <web1:EquipmentType>ANY</web1:EquipmentType> <web1:HoursOld>0</web1:HoursOld> <web1:LoadType>All</web1:LoadType> <web1:OriginCity>Chicago</web1:OriginCity> <web1:OriginCountry>USA</web1:OriginCountry> <web1:OriginLatitude>0</web1:OriginLatitude> <web1:OriginLongitude>0</web1:OriginLongitude> <web1:OriginRange>150</web1:OriginRange> <web1:OriginState>IL</web1:OriginState> <web1:PageNumber>1</web1:PageNumber> <web1:PageSize>5</web1:PageSize> <web1:SortBy>Age</web1:SortBy> <web1:SortDescending>false</web1:SortDescending> </web1:Criteria> </v12:searchRequest> </v12:GetMultipleTruckDetailResults> </soapenv:Body> </soapenv:Envelope>'<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <GetMultipleTruckDetailResultsResponse xmlns="http://webservices.truckstop.com/v12"> <GetMultipleTruckDetailResultsResult 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:TruckDetails> <a:MultipleTruckDetailResult> <a:CarrierRating/> <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID> <a:DOTNumber/> <a:DateTruckAvailable>10/21/24</a:DateTruckAvailable> <a:DestinationCity/> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationRadius>0</a:DestinationRadius> <a:DestinationState/> <a:DispatchName>AlanA</a:DispatchName> <a:DispatchPhone>305-297-1064</a:DispatchPhone> <a:Entered>2024-10-21T10:46:51.667</a:Entered> <a:EnteredUtc>2024-10-21T10:46:51.667Z</a:EnteredUtc> <a:Equipment>SPV</a:Equipment> <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/> <a:EquipmentTypes xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:Category>S</b:Category> <b:CategoryId>4</b:CategoryId> <b:Code>SPV</b:Code> <b:Description>Cargo/Small/Sprinter Van</b:Description> <b:FullLoad i:nil="true"/> <b:Id>1188</b:Id> <b:IsCategorizable>false</b:IsCategorizable> <b:IsCombo>false</b:IsCombo> <b:IsTruckPost>false</b:IsTruckPost> <b:MapToId>1188</b:MapToId> <b:RequiredOption i:nil="true"/> <b:WebserviceOnly>false</b:WebserviceOnly> </a:EquipmentTypes> <a:HasFileCheck>false</a:HasFileCheck> <a:ID>66336104</a:ID> <a:IsDaily>false</a:IsDaily> <a:IsFriend>false</a:IsFriend> <a:IsFullTruck>false</a:IsFullTruck> <a:Length>14.00</a:Length> <a:MCNumber/> <a:MinMiles>0</a:MinMiles> <a:OriginCity>Chicago</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginRadius>0</a:OriginRadius> <a:OriginState>IL</a:OriginState> <a:PerMile>0</a:PerMile> <a:PercentFull/> <a:PointOfContact>AlanA</a:PointOfContact> <a:PointOfContactPhone>305-297-1064</a:PointOfContactPhone> <a:Quantity>1</a:Quantity> <a:SpecInfo/> <a:TCAMember>false</a:TCAMember> <a:TMCNumber/> <a:TimeTruckAvailable/> <a:TruckCompanyCity>New Plymouth</a:TruckCompanyCity> <a:TruckCompanyEmail>[email protected]</a:TruckCompanyEmail> <a:TruckCompanyFax/> <a:TruckCompanyId>452460</a:TruckCompanyId> <a:TruckCompanyName>Partnership At Truckstop</a:TruckCompanyName> <a:TruckCompanyPhone>305-297-1064</a:TruckCompanyPhone> <a:TruckCompanyState>ID</a:TruckCompanyState> <a:TruckDesiredDirection/> <a:TruckNumber i:nil="true"/> <a:Weight>3500</a:Weight> <a:WhenPostedUtc>2024-10-21T10:46:51.667Z</a:WhenPostedUtc> <a:Width>0</a:Width> <a:DestinationDistance>0</a:DestinationDistance> <a:OriginDistance>0</a:OriginDistance> </a:MultipleTruckDetailResult> <a:MultipleTruckDetailResult> <a:CarrierRating/> <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID> <a:DOTNumber/> <a:DateTruckAvailable>10/22/24</a:DateTruckAvailable> <a:DestinationCity/> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationRadius>0</a:DestinationRadius> <a:DestinationState/> <a:DispatchName>AlanA</a:DispatchName> <a:DispatchPhone>305-297-1064</a:DispatchPhone> <a:Entered>2024-10-21T10:46:51.657</a:Entered> <a:EnteredUtc>2024-10-21T10:46:51.657Z</a:EnteredUtc> <a:Equipment>SPV</a:Equipment> <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/> <a:EquipmentTypes xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:Category>S</b:Category> <b:CategoryId>4</b:CategoryId> <b:Code>SPV</b:Code> <b:Description>Cargo/Small/Sprinter Van</b:Description> <b:FullLoad i:nil="true"/> <b:Id>1188</b:Id> <b:IsCategorizable>false</b:IsCategorizable> <b:IsCombo>false</b:IsCombo> <b:IsTruckPost>false</b:IsTruckPost> <b:MapToId>1188</b:MapToId> <b:RequiredOption i:nil="true"/> <b:WebserviceOnly>false</b:WebserviceOnly> </a:EquipmentTypes> <a:HasFileCheck>false</a:HasFileCheck> <a:ID>66336103</a:ID> <a:IsDaily>false</a:IsDaily> <a:IsFriend>false</a:IsFriend> <a:IsFullTruck>false</a:IsFullTruck> <a:Length>14.00</a:Length> <a:MCNumber/> <a:MinMiles>0</a:MinMiles> <a:OriginCity>Chicago</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginRadius>0</a:OriginRadius> <a:OriginState>IL</a:OriginState> <a:PerMile>0</a:PerMile> <a:PercentFull/> <a:PointOfContact>AlanA</a:PointOfContact> <a:PointOfContactPhone>305-297-1064</a:PointOfContactPhone> <a:Quantity>1</a:Quantity> <a:SpecInfo/> <a:TCAMember>false</a:TCAMember> <a:TMCNumber/> <a:TimeTruckAvailable/> <a:TruckCompanyCity>New Plymouth</a:TruckCompanyCity> <a:TruckCompanyEmail>[email protected]</a:TruckCompanyEmail> <a:TruckCompanyFax/> <a:TruckCompanyId>452460</a:TruckCompanyId> <a:TruckCompanyName>Partnership At Truckstop</a:TruckCompanyName> <a:TruckCompanyPhone>305-297-1064</a:TruckCompanyPhone> <a:TruckCompanyState>ID</a:TruckCompanyState> <a:TruckDesiredDirection/> <a:TruckNumber i:nil="true"/> <a:Weight>3500</a:Weight> <a:WhenPostedUtc>2024-10-21T10:46:51.657Z</a:WhenPostedUtc> <a:Width>0</a:Width> <a:DestinationDistance>0</a:DestinationDistance> <a:OriginDistance>0</a:OriginDistance> </a:MultipleTruckDetailResult> <a:MultipleTruckDetailResult> <a:CarrierRating/> <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID> <a:DOTNumber/> <a:DateTruckAvailable>5/4/24</a:DateTruckAvailable> <a:DestinationCity>Vincentown</a:DestinationCity> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationRadius>0</a:DestinationRadius> <a:DestinationState>NJ</a:DestinationState> <a:DispatchName>Dispatch</a:DispatchName> <a:DispatchPhone>609-252-8177</a:DispatchPhone> <a:Entered>2024-10-18T10:08:15.7</a:Entered> <a:EnteredUtc>2024-10-18T10:08:15.7Z</a:EnteredUtc> <a:Equipment>F</a:Equipment> <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:TrailerOptionType>Tarps</b:TrailerOptionType> <b:TrailerOptionType>Hazardous</b:TrailerOptionType> </a:EquipmentOptions> <a:EquipmentTypes xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:Category>F</b:Category> <b:CategoryId>1</b:CategoryId> <b:Code>F</b:Code> <b:Description>Flatbed</b:Description> <b:FullLoad i:nil="true"/> <b:Id>12</b:Id> <b:IsCategorizable>true</b:IsCategorizable> <b:IsCombo>false</b:IsCombo> <b:IsTruckPost>true</b:IsTruckPost> <b:MapToId>12</b:MapToId> <b:RequiredOption i:nil="true"/> <b:WebserviceOnly>false</b:WebserviceOnly> </a:EquipmentTypes> <a:HasFileCheck>false</a:HasFileCheck> <a:ID>66290528</a:ID> <a:IsDaily>false</a:IsDaily> <a:IsFriend>false</a:IsFriend> <a:IsFullTruck>true</a:IsFullTruck> <a:Length>1.00</a:Length> <a:MCNumber/> <a:MinMiles>0</a:MinMiles> <a:OriginCity>Bridgman</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginRadius>0</a:OriginRadius> <a:OriginState>MI</a:OriginState> <a:PerMile>0</a:PerMile> <a:PercentFull/> <a:PointOfContact>Dispatch</a:PointOfContact> <a:PointOfContactPhone>609-252-8177</a:PointOfContactPhone> <a:Quantity>1</a:Quantity> <a:SpecInfo/> <a:TCAMember>false</a:TCAMember> <a:TMCNumber/> <a:TimeTruckAvailable/> <a:TruckCompanyCity>Princeton</a:TruckCompanyCity> <a:TruckCompanyEmail/> <a:TruckCompanyFax/> <a:TruckCompanyId>424412</a:TruckCompanyId> <a:TruckCompanyName>Trimble</a:TruckCompanyName> <a:TruckCompanyPhone>609-252-8177</a:TruckCompanyPhone> <a:TruckCompanyState>NJ</a:TruckCompanyState> <a:TruckDesiredDirection/> <a:TruckNumber i:nil="true"/> <a:Weight>1</a:Weight> <a:WhenPostedUtc>2024-05-03T07:48:11.313Z</a:WhenPostedUtc> <a:Width>1</a:Width> <a:DestinationDistance>72</a:DestinationDistance> <a:OriginDistance>58</a:OriginDistance> </a:MultipleTruckDetailResult> <a:MultipleTruckDetailResult> <a:CarrierRating/> <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID> <a:DOTNumber/> <a:DateTruckAvailable>5/3/24</a:DateTruckAvailable> <a:DestinationCity>Vincentown</a:DestinationCity> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationRadius>0</a:DestinationRadius> <a:DestinationState>NJ</a:DestinationState> <a:DispatchName>Dispatch</a:DispatchName> <a:DispatchPhone>609-252-8177</a:DispatchPhone> <a:Entered>2024-10-18T10:08:15.7</a:Entered> <a:EnteredUtc>2024-10-18T10:08:15.7Z</a:EnteredUtc> <a:Equipment>F</a:Equipment> <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:TrailerOptionType>Tarps</b:TrailerOptionType> <b:TrailerOptionType>Hazardous</b:TrailerOptionType> </a:EquipmentOptions> <a:EquipmentTypes xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:Category>F</b:Category> <b:CategoryId>1</b:CategoryId> <b:Code>F</b:Code> <b:Description>Flatbed</b:Description> <b:FullLoad i:nil="true"/> <b:Id>12</b:Id> <b:IsCategorizable>true</b:IsCategorizable> <b:IsCombo>false</b:IsCombo> <b:IsTruckPost>true</b:IsTruckPost> <b:MapToId>12</b:MapToId> <b:RequiredOption i:nil="true"/> <b:WebserviceOnly>false</b:WebserviceOnly> </a:EquipmentTypes> <a:HasFileCheck>false</a:HasFileCheck> <a:ID>66290529</a:ID> <a:IsDaily>false</a:IsDaily> <a:IsFriend>false</a:IsFriend> <a:IsFullTruck>true</a:IsFullTruck> <a:Length>1.00</a:Length> <a:MCNumber/> <a:MinMiles>0</a:MinMiles> <a:OriginCity>Bridgman</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginRadius>0</a:OriginRadius> <a:OriginState>MI</a:OriginState> <a:PerMile>0</a:PerMile> <a:PercentFull/> <a:PointOfContact>Dispatch</a:PointOfContact> <a:PointOfContactPhone>609-252-8177</a:PointOfContactPhone> <a:Quantity>1</a:Quantity> <a:SpecInfo/> <a:TCAMember>false</a:TCAMember> <a:TMCNumber/> <a:TimeTruckAvailable/> <a:TruckCompanyCity>Princeton</a:TruckCompanyCity> <a:TruckCompanyEmail/> <a:TruckCompanyFax/> <a:TruckCompanyId>424412</a:TruckCompanyId> <a:TruckCompanyName>Trimble</a:TruckCompanyName> <a:TruckCompanyPhone>609-252-8177</a:TruckCompanyPhone> <a:TruckCompanyState>NJ</a:TruckCompanyState> <a:TruckDesiredDirection/> <a:TruckNumber i:nil="true"/> <a:Weight>1</a:Weight> <a:WhenPostedUtc>2024-05-03T07:48:11.317Z</a:WhenPostedUtc> <a:Width>1</a:Width> <a:DestinationDistance>72</a:DestinationDistance> <a:OriginDistance>58</a:OriginDistance> </a:MultipleTruckDetailResult> <a:MultipleTruckDetailResult> <a:CarrierRating/> <a:CompanyID>00000000-0000-0000-0000-000000000000</a:CompanyID> <a:DOTNumber/> <a:DateTruckAvailable>6/2/24</a:DateTruckAvailable> <a:DestinationCity/> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationRadius>100</a:DestinationRadius> <a:DestinationState/> <a:DispatchName>Dispatch</a:DispatchName> <a:DispatchPhone>609-252-8177</a:DispatchPhone> <a:Entered>2024-10-18T10:08:15.7</a:Entered> <a:EnteredUtc>2024-10-18T10:08:15.7Z</a:EnteredUtc> <a:Equipment>V</a:Equipment> <a:EquipmentOptions xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"/> <a:EquipmentTypes xmlns:b="http://schemas.datacontract.org/2004/07/Truckstop2.Objects"> <b:Category>V</b:Category> <b:CategoryId>2</b:CategoryId> <b:Code>V</b:Code> <b:Description>Van</b:Description> <b:FullLoad i:nil="true"/> <b:Id>43</b:Id> <b:IsCategorizable>true</b:IsCategorizable> <b:IsCombo>false</b:IsCombo> <b:IsTruckPost>true</b:IsTruckPost> <b:MapToId>43</b:MapToId> <b:RequiredOption i:nil="true"/> <b:WebserviceOnly>false</b:WebserviceOnly> </a:EquipmentTypes> <a:HasFileCheck>false</a:HasFileCheck> <a:ID>66290530</a:ID> <a:IsDaily>false</a:IsDaily> <a:IsFriend>false</a:IsFriend> <a:IsFullTruck>false</a:IsFullTruck> <a:Length>0.00</a:Length> <a:MCNumber/> <a:MinMiles>0</a:MinMiles> <a:OriginCity>chicago</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginRadius>100</a:OriginRadius> <a:OriginState>il</a:OriginState> <a:PerMile>3</a:PerMile> <a:PercentFull/> <a:PointOfContact>Dispatch</a:PointOfContact> <a:PointOfContactPhone>609-252-8177</a:PointOfContactPhone> <a:Quantity>1</a:Quantity> <a:SpecInfo>15</a:SpecInfo> <a:TCAMember>false</a:TCAMember> <a:TMCNumber/> <a:TimeTruckAvailable>12:00:00</a:TimeTruckAvailable> <a:TruckCompanyCity>Princeton</a:TruckCompanyCity> <a:TruckCompanyEmail/> <a:TruckCompanyFax/> <a:TruckCompanyId>424412</a:TruckCompanyId> <a:TruckCompanyName>Trimble</a:TruckCompanyName> <a:TruckCompanyPhone>609-252-8177</a:TruckCompanyPhone> <a:TruckCompanyState>NJ</a:TruckCompanyState> <a:TruckDesiredDirection/> <a:TruckNumber i:nil="true"/> <a:Weight>0</a:Weight> <a:WhenPostedUtc>2024-05-03T07:51:11.86Z</a:WhenPostedUtc> <a:Width>1</a:Width> <a:DestinationDistance>0</a:DestinationDistance> <a:OriginDistance>0</a:OriginDistance> </a:MultipleTruckDetailResult> </a:TruckDetails> </GetMultipleTruckDetailResultsResult> </GetMultipleTruckDetailResultsResponse> </s:Body> </s:Envelope>