# GET /partner/dispatch/shipments/{shipment_id}

Read a B2B order back by its id. Requires the dispatch:write scope.

Source: https://docs.sealtrust.io/en/reference/get-partner-dispatch-shipments-id/

---

You read an order back by the `id` returned at its creation: its status, its
distributor and territory, and the number of units in the box.
The whole flow is in the guide [Tie each unit to its order](/en/expedition-b2b/).

## Authorization

API key in the `Authorization` header, `Bearer` format, with the
`dispatch:write` scope. A key without it gets a 403 whose message names the
missing scope. The plan of the key's brand must include API access, and the
shipment's brand must be on the Compliance + Identity offer.

```http
Authorization: Bearer votre_clef
```

## Rate limit

The same as the other partner routes: one counter per key and one for the sum
of your brand's keys, 120 calls per 60-second window by default. A read takes nothing from the daily quota.

## Example request

```bash
curl -i -X GET "https://api.sealtrust.io/v1/partner/dispatch/shipments/318" \
  -H "Authorization: Bearer st_live_0000000000000000000000000000000000000000000000"
```

## Example response

HTTP 200, the same object as the creation, without the `created` field.

## Errors

| Code | Condition | What to do |
| --- | --- | --- |
| 401 | Key missing, malformed or unknown. | Send `Authorization: Bearer <your key>` with the whole key. |
| 403 | The key lacks the `dispatch:write` scope. Message `Missing required scopes: dispatch:write`. | Create a key that carries this scope. |
| 403 | The brand is on the Compliance offer. `detail.code` is `OFFER_EXCLUDES_IDENTITY` and `detail.feature` is `dispatch`. Nothing is recorded. | Move to the Compliance + Identity offer. Retrying changes nothing. |
| 429 | Rate limit or daily quota reached. | Wait the number of seconds in `Retry-After`, or midnight UTC for the quota. |
| 404 | No shipment of your brand has this id. A shipment of another brand gets exactly the same answer. | Check the `id` returned at creation. |