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

Relire une commande B2B par son identifiant. Droit dispatch:write.

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

---

Vous relisez une commande par l'`id` rendu à sa création : son statut, son
distributeur et son territoire, et le nombre d'unités dans le carton.
Le parcours complet est dans le guide [Rattacher chaque unité à sa commande](/expedition-b2b/).

## Autorisation

Clef d'API dans l'en-tête `Authorization`, au format `Bearer`, avec le droit
`dispatch:write`. Une clef sans ce droit reçoit un 403 dont le message nomme le
droit manquant. L'offre de la marque de la clef doit comprendre l'accès API, et
la marque de l'expédition doit être sur l'offre Conformité + Identité.

```http
Authorization: Bearer votre_clef
```

## Plafond d'appels

Le même que les autres routes partenaires : un compteur par clef et un compteur
pour la somme des clefs de votre marque, 120 appels par fenêtre de 60 secondes
par défaut. Une lecture ne prélève rien sur le quota journalier.

## Requête d'exemple

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

## Réponse d'exemple

Code HTTP 200, le même objet que la création, sans le champ `created`.

## Erreurs

| Code | Condition | Que faire |
| --- | --- | --- |
| 401 | Clef absente, mal formée ou inconnue. | Envoyez `Authorization: Bearer <votre clef>` avec la clef entière. |
| 403 | La clef n'a pas le droit `dispatch:write`. Message `Missing required scopes: dispatch:write`. | Créez une clef qui porte ce droit. |
| 403 | La marque est sur l'offre Conformité. `detail.code` vaut `OFFER_EXCLUDES_IDENTITY` et `detail.feature` vaut `dispatch`. Rien n'est enregistré. | Passez à l'offre Conformité + Identité. Réessayer ne changera rien. |
| 429 | Plafond de débit ou quota journalier atteint. | Attendez le nombre de secondes de `Retry-After`, ou minuit en temps universel pour le quota. |
| 404 | Aucune expédition de votre marque ne porte cet identifiant. Une expédition d'une autre marque répond exactement la même chose. | Vérifiez l'`id` rendu à la création. |