freight
Get freight quotes
<aside class="access" aria-label="Endpoint access"> <table class="access__table"> <thead> <tr> <th class="access__table-header">Products</th> <th class="access__table-header">Plans</th> </tr> </thead> <tbody> <tr> <td class="access__table-cell access__product"> <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/> <div class="access__sub">Formerly ShipEngine</div> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a> </td> </tr> <tr> <td class="access__table-cell"> <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a> </td> </tr> </tbody> </table> <footer class="access__footer"> <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md"> Learn about products and plans <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/> </a> </footer> </aside>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/v2/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
}
]
}