| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### URL Expired

The URL for this request expired after 30 days.

### Parameters

**businessDaysOfTransit**  
Type: `int32`  
Indicates the number of business days from the ship time by when the shipment needs to be delivered.

**currencyCode**  
Type: `string`  
ISO-4217 currency code in which all the rates for shipping will be calculated and returned. This will override the value configured in the root level `units` object. If the root level `units` object is not provided, this field will be required.

**desiredDeliveryDate**  
Type: `string`  
The string representation of either an ISO-8601 date or a LocalDate: yyyy-mm-dd. The date or datetime the package is intended to arrive to the customer. This will be used to determine the most appropriate service method when generating a label.

**desiredDeliveryDateOptions**  
Type: `object`  
Options for how the system will use the desiredDeliveryDate.

**destinationAddress**  
Type: `object`  
Required: Yes  
Address details of the sold to party for customs purposes.

**existingShipmentIds**  
Type: `array of strings`  
The Shipium or partner shipment IDs that should be included in this LTL shipment. These must be IDs for shipments created using the `/api/v1/deliveryexperience/shipment` endpoint, or an equivalent endpoint. These cannot be LTL shipments, must have `nmfcFreightClass` configured, and must have the same ship from and destination addresses as this LTL shipment. At least one of `existingShipmentIds`, `shipments`, and `packedShipments` must not be empty or null.

**includeEvaluatedServiceMethodsInResponse**  
Type: `boolean`  
Defaults to false. When "true" a request will expand information on the response to include unselected carriers and service methods that made it through filtering.

**includeLineItemsInEvaluatedServiceMethods**  
Type: `boolean`  
When "true" a response will include line item information for the returned evaluated service methods, provided that includeEvaluatedServiceMethodsInResponse is also set to true.

**ltlShipmentParameters**  
Type: `object`  
Required: Yes  
Request parameters that informed LTL costing and carrier selection.

**packedShipments**  
Type: `array of objects`  
The already packed LTL shipments that should be included in this LTL shipment. Items in this list will only be used for LTL costing and will not have their packaging modified, nor be eligible for parcel carrier selection.

**partnerLtlCostId**  
Type: `string`  
An optional unique identifier that may be used for this LTL cost.

**returnToAddress**  
Type: `object`  
Address details of the sold to party for customs purposes.

**shipFromAddress**  
Type: `object`  
Required: Yes  
Address details of the sold to party for customs purposes.

**shippedDateTime**  
Type: `date-time`  
The timestamp for when you (or your fulfillment partner) shipped the product from your (or their) warehouse. The timestamp must be a valid ISO 8601 timestamp.

**shipments**  
Type: `array of objects`  
The shipments that should be included in this LTL shipment. At least one of `existingShipmentIds`, `shipments`, and `packedShipments` must not be empty or null.

**tenantId**  
Type: `string`  
Either the Shipium tenant ID or the partner-provided tenant ID that the shipment is for.

**testMode**  
Type: `boolean`  
Defaults to false. Indicates that a testMode LTL cost and shipment will be created.

**units**  
Type: `object`  
The units that all dimensions and currencies in the response are in, unless overridden in a narrower scope.

**packageShipmentParameters**  
Type: `object`  
Request parameters that informed package shipments and carrier selection.

### Example Request

```bash
curl --request POST \
     --url https://api.shipium.com/api/v1/ltl/shipment/costCompare \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '@@JSON_PAYLOAD'
```

### Example Responses

- `200`: The estimated cost of the LTL shipment with a comparison to using parcel shipping.
- `400`: Invalid inputs were provided.
- `503`: Service is at capacity; retry after a brief delay.