# GET /partner/dispatch/shipments

Relire une commande B2B par sa référence de commande. Droit dispatch:write.

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

---

Vous relisez une commande par sa référence, celle que vous avez envoyée à la
création. 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.

## Paramètres de requête

| Nom | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `order_ref` | `string` | oui | La référence de commande, 1 à 100 caractères. |
| `brand_code` | `string` | non | Avec une clef revendeur, la marque cliente. |

## Requête d'exemple

```bash
curl -i -X GET "https://api.sealtrust.io/v1/partner/dispatch/shipments?order_ref=SO-2026-1042" \
  -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 commande de votre marque ne porte cette référence. | Vérifiez la référence et `brand_code`. |