freight
Book a freight shipment
<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>Book one of the offers returned by Get freight quotes. Booking dispatches the shipment with the LTL carrier and generates the shipment's documents, such as the Bill of Lading.
As with quoting, there are two ways to book:
- Linked to an existing shipment. Provide shipment_id. The shipment must already have a freight quote — call Get freight quotes for it first. The origin, destination, and handling units all come from the shipment and its saved freight configuration, so ship_from, ship_to, and handling_units must be omitted.
- Inline. Omit shipment_id and provide ship_from, ship_to, and handling_units. A shipment record is created for the booking and marked as shipped.
quote_request_id, offer_id, carrier_scac, and quote_expiration_date must be copied from the offer you are booking. Quotes are short-lived: booking an offer whose quote_expiration_date has passed returns a 400 Bad Request, and you need to request new quotes.
post/v2/freight/shipments
Request body
Example request
{
"freight_provider_account_id": "se-28529731",
"shipment_id": "se-28529731",
"quote_request_id": "7f1c9a52-3d84-4f0e-9b3a-2c6d5e4f8a10",
"offer_id": "0f2b41d8-6a17-4c9e-8f52-b71d3e9c4a68",
"quote_expiration_date": "2026-04-16T23:59:59Z",
"carrier_scac": "FXFE",
"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"
},
"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."
}
}
]
}
],
"pickup_details": {
"pickup_date": "2026-04-17T00:00:00Z",
"ready_time": "09:00",
"close_time": "16:30",
"location_type": "commercial"
},
"references": [
{
"type": "purchase_order",
"value": "PO-84213"
}
],
"pickup_instructions": "Check in with the guard at gate 3 before backing into dock 12.",
"delivery_instructions": "Delivery appointments accepted between 08:00 and 11:00 only.",
"handling_instructions": "Do not double stack. Load with forks from the long side."
}Response
The request was a success.
Example response
{
"freight_shipment_id": "se-28529731",
"freight_provider_account_id": "se-28529731",
"freight_provider_name": "UNISHIPPERS",
"status": "booked",
"product_transaction_id": "7f1c9a52-3d84-4f0e-9b3a-2c6d5e4f8a10",
"pickup_transaction_id": "3ac81f60-92b7-4de1-8f04-5b9a7c2e6d13",
"bol_number": "BOL-20260417-4821",
"pro_number": "072-51293847",
"confirmation_number": "FXFE-PU-884215",
"documents": [
{
"type": "BILL_OF_LADING"
}
]
}