This API call is recommended as this combines the results from both the GetLoadSearchResults and GetLoadSearchDetailResults using fewer API calls.
POST | /v13/Searching/LoadSearch.svc | Get multiple load search results with the details for loads based on search criteria. |
---|---|---|
Authorization | Username, Password, & Integration ID | |
SOAP Action | http://webservices.truckstop.com/v12/ILoadSearch/GetMultipleLoadDetailResults | |
Content Type | text/xml | |
Accept | text/xml | |
URL Params | None | |
Body Params | XML data |
Multiple Load Details Results
Input Output LoadSearchRequest MultipleLoadDetailReturn Notes:
- For origin and destination, a single state or multiple states are acceptable with a maximum of 15 states each.
- Origin is required
- Destination is optional.
- To search for loads 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 to return all results.
- Sort functionality is available to specify a column to sort on and the sort order. The sort column is a specified list of column names. See SortColumns enum. The SortDescending field is a Boolean value that indicates Ascending order when false, and Descending order when true.
Sample Request/Responsecurl --location 'https://testws.truckstop.com/v13/Searching/LoadSearch.svc' \ --header 'Content-Type: text/xml' \ --header 'SOAPAction: http://webservices.truckstop.com/v12/ILoadSearch/GetMultipleLoadDetailResults' \ --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.Searching" xmlns:truc="http://schemas.datacontract.org/2004/07/Truckstop2.Objects" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <soapenv:Header/> <soapenv:Body> <v12:GetMultipleLoadDetailResults> <v12:searchRequest> <web:IntegrationId>12345</web:IntegrationId> <web:Password>MyPass123!</web:Password> <web:UserName>MyWSUsername</web:UserName> <web1:Criteria> <!--Optional:--> <web1:DestinationCity>Garden City</web1:DestinationCity> <!--Optional:--> <web1:DestinationCountry>usa</web1:DestinationCountry> <!--Optional:--> <web1:DestinationRange>100</web1:DestinationRange> <!--Optional:--> <web1:DestinationState>GA</web1:DestinationState> <web1:EquipmentOptions> <!-- Zero or more iterations:--> <truc:TrailerOptionType>Tarps</truc:TrailerOptionType> </web1:EquipmentOptions> <web1:EquipmentType>F</web1:EquipmentType> <web1:HoursOld>0</web1:HoursOld> <web1:LoadType>All</web1:LoadType> <web1:OriginCity>Los Angeles</web1:OriginCity> <web1:OriginCountry>usa</web1:OriginCountry> <web1:OriginRange>300</web1:OriginRange> <web1:OriginState>CA</web1:OriginState> <web1:PageNumber>1</web1:PageNumber> <web1:PageSize>50</web1:PageSize> <web1:PickupDates> <!-- Zero or more iterations:--> <arr:dateTime>2024-10-29T00:00:00</arr:dateTime> </web1:PickupDates> <web1:SortBy>Age</web1:SortBy> <web1:SortDescending>false</web1:SortDescending> </web1:Criteria> </v12:searchRequest> </v12:GetMultipleLoadDetailResults> </soapenv:Body> </soapenv:Envelope>'
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <GetMultipleLoadDetailResultsResponse xmlns="http://webservices.truckstop.com/v12"> <GetMultipleLoadDetailResultsResult 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:DetailResults> <a:MultipleLoadDetailResult> <a:Age>9+</a:Age> <a:Bond>0</a:Bond> <a:BondTypeID>9999</a:BondTypeID> <a:Credit>----</a:Credit> <a:DOTNumber/> <a:DeletedId>0</a:DeletedId> <a:DeliveryDate>2/20/25</a:DeliveryDate> <a:DeliveryTime>07:00</a:DeliveryTime> <a:DestinationCity>Washington</a:DestinationCity> <a:DestinationCountry>USA</a:DestinationCountry> <a:DestinationDistance>0</a:DestinationDistance> <a:DestinationState>DC</a:DestinationState> <a:DestinationZip i:nil="true"/> <a:Distance>0</a:Distance> <a:Entered>2025-02-17T07:37:46.67</a:Entered> <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:ExperienceFactor>N</a:ExperienceFactor> <a:FuelCost>$1,533.00</a:FuelCost> <a:HandleName>MasteryTestUser2@mailinator.truckstop.com</a:HandleName> <a:HasBonding>false</a:HasBonding> <a:ID>6714481</a:ID> <a:IsDeleted>false</a:IsDeleted> <a:IsFriend>false</a:IsFriend> <a:Length>101.0</a:Length> <a:LoadType>Full</a:LoadType> <a:MCNumber/> <a:Mileage>2665</a:Mileage> <a:OriginCity>Long Beach</a:OriginCity> <a:OriginCountry>USA</a:OriginCountry> <a:OriginDistance>20</a:OriginDistance> <a:OriginState>CA</a:OriginState> <a:OriginZip i:nil="true"/> <a:PaymentAmount>0</a:PaymentAmount> <a:PickupDate>2/19/25</a:PickupDate> <a:PickupTime>08:00</a:PickupTime> <a:PointOfContact>TMC Dispatch</a:PointOfContact> <a:PointOfContactPhone>333-444-5556</a:PointOfContactPhone> <a:PricePerGallon>3.1630</a:PricePerGallon> <a:Quantity>1</a:Quantity> <a:SpecInfo/> <a:Stops>0</a:Stops> <a:TMCNumber/> <a:TruckCompanyCity>Des Moines</a:TruckCompanyCity> <a:TruckCompanyEmail i:nil="true"/> <a:TruckCompanyFax/> <a:TruckCompanyId>424973</a:TruckCompanyId> <a:TruckCompanyName>Mastery - TMS</a:TruckCompanyName> <a:TruckCompanyPhone>877-800-4862</a:TruckCompanyPhone> <a:TruckCompanyState>IA</a:TruckCompanyState> <a:Weight>899</a:Weight> <a:Width>103.00</a:Width> </a:MultipleLoadDetailResult> </a:DetailResults> </GetMultipleLoadDetailResultsResult> </GetMultipleLoadDetailResultsResponse> </s:Body> </s:Envelope>