---
title: "Retrieve details from a shipment"
method: GET
path: "/api/v2/shipments/{shipment_id}"
tags: ["Shipments"]
---

# Retrieve details from a shipment

`GET /api/v2/shipments/{shipment_id}`

## Response `200`

Shipment was found

- object
  - `id` string, uuid — Unique identifier for this shipment
  - `ref_number` string — Internal client's reference, such as an ID, of the load
  - `bol_number` string — The bill of lading number
  - `purchase_order_numbers` string[] — Purchase Orders (PO numbers) associated with this shipment.
  - `stops` object[] — Points of interest where the truck makes a stop to either pickup or deliver a shipment. Usually a load has one pickup stop and one delivery stop, but in some cases there will be multiple delivery stops.
    - `stop_index` number — Indicate the stop number for this event, being 0-based for pickup.
    - `address` string
    - `city` string
    - `state` string
    - `zipcode` string
  - `requirements` object — Requirements that needs to be fulfilled in order to transport the load
    - `hazmat` boolean — The commodity being moved consists of hazard material
    - `tarp` object — If present in 'requirements', it means the shipment needs a tarp
      - `size` number, float, required — size in expressed in 'ft'
      - `type` 'lumber' | 'steel' | 'smoke' | 'parachute' | 'machinery' | 'canvas' | 'hay' | 'poly'
    - `dunnage` boolean — Extra rack added to the truck
    - `beer` boolean — The carrier must be able to transport alcohool
    - `teams` boolean — If it requires a team of drivers

## Other responses

- `404` — Shipment not found

---

[API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)