freight
Get freight quotes
Retrieve freight rate offers for a shipment. Each offer in the response is a bookable quote from a specific LTL carrier.
There are two ways to request quotes:
- Inline. Describe the shipment in the request: ship_from, ship_to, and handling_units.
- Linked to an existing shipment. Provide shipment_id. The origin is taken from the shipment's ship-from warehouse and the destination from the order's ship-to address, so ship_from and ship_to must be omitted. handling_units, accessorials, and insurance are optional in this mode: when provided they are saved as the shipment's freight configuration, and when omitted the previously saved configuration is reused.
To book one of the returned offers, pass its quote_request_id, offer_id, carrier_scac, and quote_expiration_date to Book a freight shipment.
All dimensions are interpreted as inches and all weights as pounds.
post/v1/freight/quotes
Request body
Example request
{
"freight_provider_account_id": "se-28529731",
"shipment_id": "se-28529731",
"ship_from": {
"name": "Marcus Bell",
"company_name": "Northgate Distribution",
"address_line1": "4200 Industrial Pkwy",
"address_line2": "Dock 12",
"city_locality": "Grand Rapids",
"state_province": "MI",
"postal_code": "49512",
"country_code": "US",
"phone": "+1 616 555 0142",
"email": "dock@northgate-dist.example",
"location_type": "commercial"
},
"ship_to": {
"name": "Marcus Bell",
"company_name": "Northgate Distribution",
"address_line1": "4200 Industrial Pkwy",
"address_line2": "Dock 12",
"city_locality": "Grand Rapids",
"state_province": "MI",
"postal_code": "49512",
"country_code": "US",
"phone": "+1 616 555 0142",
"email": "dock@northgate-dist.example",
"location_type": "commercial"
},
"shipment_date": "2026-04-17T00:00:00Z",
"handling_units": [
{
"type": "pallet",
"quantity": 2,
"length": 48,
"width": 40,
"height": 52,
"commodities": [
{
"description": "Assembled oak dining chairs",
"quantity": 24,
"weight": 310,
"value": 4800,
"packaging_type": "carton",
"freight_class": "125",
"nmfc_code": "80700-2",
"hazardous_materials": {
"identification_number_type": "un",
"identification_number": "UN1263",
"proper_shipping_name": "Paint",
"hazard_class": "3",
"subsidiary_hazard_classes": [
"8"
],
"packing_group": "iii",
"emergency_contact_name": "Chemtrec",
"emergency_contact_phone": "+1 800 424 9300",
"emergency_response_reference": "CCN12345",
"flashpoint_temperature": 73,
"additional_details": "Keep upright. Do not stack."
}
}
]
}
],
"accessorials": {
"liftgate_pickup": true,
"liftgate_delivery": true,
"notify_before_delivery": true,
"tradeshow_pickup": {
"name": "Midwest Home & Garden Expo",
"booth_number": "B-1147"
},
"tradeshow_delivery": {
"name": "Midwest Home & Garden Expo",
"booth_number": "B-1147"
}
},
"insurance": {
"insured_value": 18500,
"item_condition": "new",
"commodity_category": "furniture",
"marks_numbers": "NG-2026-0417"
}
}Response
The request was a success.
Example response
{
"quotes": [
{
"freight_provider_account_id": "se-28529731",
"freight_provider_name": "UNISHIPPERS",
"quote_request_id": "7f1c9a52-3d84-4f0e-9b3a-2c6d5e4f8a10",
"offer_id": "0f2b41d8-6a17-4c9e-8f52-b71d3e9c4a68",
"carrier_name": "FedEx Freight Economy",
"carrier_scac": "FXFE",
"service_name": "Standard LTL",
"service_type": "Direct",
"total_charges": 842.37,
"transit_days": 3,
"estimated_delivery_date": "2026-04-22T00:00:00Z",
"origin_terminal_code": "GRR",
"destination_terminal_code": "DFW",
"insured_amount": 18500,
"insurance_premium": 46.25,
"insurance_certificate_number": "CRT-4471902",
"quote_expiration_date": "2026-04-16T23:59:59Z",
"max_liability_new": 25,
"max_liability_used": 10
}
]
}