PRproject44
LTL: Quotes

Query for rate quotes.

<h4>Required Fields</h4> <ul><li><b>originAddress:</b><ul><li> postalCode </li></ul></li><li><b>destinationAddress:</b><ul><li> postalCode </li></ul></li><li>At least one of <b>lineItems</b> or <b>enhancedHandlingUnits</b> must be provided. Passing both is also accepted.<ul><li><b>lineItems:</b><ul><li> totalWeight </li><li><b>packageDimensions:</b><ul><li> length </li><li> width </li><li> height </li></ul></li><li> freightClass </li></ul></li><li><b>enhancedHandlingUnits:</b> <u>please contact your account manager at project44 before using this field.</u><ul><li> weightPerHandlingUnit </li><li> pickupStopNumber </li><li> deliveryStopNumber </li><li><b>handlingUnitDimensions:</b><ul><li> length </li><li> width </li><li> height </li></ul></li><li> freightClasses </li></ul></li></ul></li></ul><h4>Error Messages</h4><p>A <code>200</code> response can include carriers that failed. Each failed element of <code>rateQuotes</code> carries an <code>errorMessages</code> list. Every message in that list may include an <code>errorCode</code>: the normalized project44 error code, identical across capacity providers, so integrations can branch on it instead of parsing the carrier-specific <code>message</code> or <code>diagnostic</code>. <code>errorCode</code> is omitted when no code is available. Clients must tolerate this additional field.</p>
post/api/v4/ltl/quotes/rates/query

Request

Request body

directionOverride'SHIPPER' | 'CONSIGNEE' | 'THIRD_PARTY'

An override of direction for all capacity provider accounts used by this request that have 'Enable API override of direction' set as 'true' in the project44 Self-Service Portal.This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.

lengthUnit'IN' | 'CM' | 'FT' | 'M'

Length measurement unit for all length values in this rate quote query. (default: 'IN')

paymentTermsOverride'PREPAID' | 'COLLECT' | 'THIRD_PARTY'

An override of payment terms for all capacity provider accounts used by this request that have 'Enable API override of payment terms' set as 'true' in the project44 Self-Service Portal. This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.

preferredCurrency'USD' | 'CAD' | 'MXN'

The currency that you would like the rate quote to be returned in, other than the default currency the carrier supports. If the currency is supported by the carrier, it will be returned in both the default currency and preferred currency fields. If the carrier does not support the requested currency, we will convert it on behalf of the carrier using the current exchange rate. The preferred currency will be returned in the “preferred currency” fields within the response. The carrier’s original currency will be returned in the default currency fields within the response. Exchange rate information will also be returned in the response for audit purposes.

preferredSystemOfMeasurement'METRIC' | 'IMPERIAL'

The preferred system of measurement for all values with a unit in this rate quote. The default behavior is to return the unit of measurement specified by the carrier in the response.

totalLinearFeetinteger

The total linear feet that the shipment being quoted will take up in a trailer. Required only for volume LTL shipments. Customers who have enabled our Volume Visualizer product may submit rate requests without providing a value for totalLinearFeet. Linear footage will be automatically calculated, based on line item details, and submitted with your rate request. If a value is provided for totalLinearFeet, it will be submitted with the request and no calculation will be performed.

weightUnit'LB' | 'KG'

Weight measurement unit for all weight values in this rate quote query. (default: 'LB')

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.