latestOpenAPI 3.1.0MIT2026-08-221643491.4 MB

d3d8c21cd227

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

freight_provider_account_idstring required

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

shipment_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

shipment_datestring date-time nullable

The date the freight is ready to ship. Defaults to the current date when omitted.

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
    }
  ]
}