Sign in
latestOpenAPI 3.0.0Proprietary2026-08-22131410675.6 KB

8d8a7cf79204

freight

Get freight shipment by ID

Retrieve a single freight shipment, including its current status, carrier reference numbers, and the documents generated for it.

get/v1/freight/shipments/{freight_shipment_id}

Response

The request was a success.

freight_shipment_idstring

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

freight_provider_account_idstring

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

freight_provider_namestring

The code of the freight provider the shipment was booked through.

status'pending' | 'quoted' | 'booked' | 'in_transit' | 'delivered' | 'cancelled' | 'exception'

The lifecycle status of a freight shipment. exception is also returned when the status cannot be determined.

product_transaction_idstring nullable

The provider's identifier for the booked shipment.

pickup_transaction_idstring nullable

The provider's identifier for the pickup request. null when no pickup was requested.

bol_numberstring nullable

The Bill of Lading number assigned to the shipment.

pro_numberstring nullable

The carrier's PRO number for the shipment, or null until the carrier assigns one.

confirmation_numberstring nullable

The carrier's pickup confirmation number. null when the carrier did not return one.

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",
      "url": "/v1/downloads/10/a1b2c3d4e5f6/bill_of_lading.pdf"
    }
  ]
}