---
title: "Get freight shipment by ID"
method: GET
path: "/v1/freight/shipments/{freight_shipment_id}"
tags: ["freight"]
---

# Get freight shipment by ID

`GET /v1/freight/shipments/{freight_shipment_id}`

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

## Response `200`

The request was a success.

- FreightShipmentResponseBody — A freight shipment on your account.
  - `freight_shipment_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
  - `freight_provider_account_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
  - `freight_provider_name` string — 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_id` string, nullable — The provider's identifier for the booked shipment.
  - `pickup_transaction_id` string, nullable — The provider's identifier for the pickup request. `null` when no pickup was requested.
  - `bol_number` string, nullable — The Bill of Lading number assigned to the shipment.
  - `pro_number` string, nullable — The carrier's PRO number for the shipment, or `null` until the carrier assigns one.
  - `confirmation_number` string, nullable — The carrier's pickup confirmation number. `null` when the carrier did not return one.
  - `documents` FreightShipmentDocument[], nullable — The documents stored for the shipment, each with a download URL. `null` when no documents have been stored yet.
    - `document_id` integer, nullable — Always `null`. Reserved for future use.
    - `type` 'bill_of_lading' | 'bol_pallet_label_combined' | 'certificate_of_insurance' | 'certificate_of_insurance_instructions' | 'certificate_of_origin_us' | 'certificate_of_origin_usmca' | 'certificate_of_origin_usmca_instructions' | 'international_commercial_invoice' | 'packing_list' | 'pallet_label' | 'pallet_label_4x6' | 'proof_of_delivery' | 'quote' | 'weight_and_inspection' — The type of document.
    - `url` string, nullable — The path to download the document as a PDF, relative to the API host. Resolve it against `https://api.shipengine.com` to get the full URL.

## Other responses

- `400` — The request contained errors.
- `404` — The freight shipment does not exist on this account.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

---

[API](https://skmtc.net/shipstation/apis/shipengine-api.md) · [All operations](https://skmtc.net/shipstation/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipengine-api/revisions/8d8a7cf79204/schema)