> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dexnotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Statuts et accusés de réception

> Suivre un envoi jusqu’au téléphone du destinataire.

```text theme={null}
Message        scheduled → queued → sending → completed | partially_failed | failed
                    └─────────┴─────────┴──▶ cancelled
Destinataire   pending → sending → sent → delivered | failed | expired
                                  └──▶ outcome_unknown → sent | delivered | failed | expired
```

| Statut du destinataire | Sens |
| - | - |
| `sent` | l’opérateur a accepté le SMS |
| `delivered` | l’accusé de réception (DLR) de l’opérateur dit qu’il est arrivé |
| `failed`, `expired` | non remis ; les unités sont remboursées |
| `outcome_unknown` | la requête est partie, l’opérateur n’a pas répondu |

> [!NOTE]
>
> Un SMS en `outcome_unknown` n’est **jamais renvoyé** : il a peut-être été reçu. Ses unités restent réservées jusqu’à ce que l’opérateur tranche.

**Le message** se conclut quand plus aucun destinataire n’attend : `completed` si tous sont partis, `failed` si aucun, `partially_failed` sinon.

## Les routes

| Route | Rend |
| - | - |
| `GET /api/v1/sms/messages/{id}` | statut, compteurs par statut, unités ; le destinataire d’un envoi unique |
| `GET /api/v1/sms/messages/{id}/recipients?status=` | les destinataires, paginés, avec leur code d’erreur |
| `GET /api/v1/sms/messages/{id}/report` | répartition par statut et par pays, accusés de réception cumulés |
| `GET /api/v1/sms/messages?status=&from=&to=&page=` | l’historique du projet |
| `GET /api/v1/sms/messages/export` | le même historique en CSV |
| `GET /api/v1/sms/stats` | envoyés, remis, échecs, unités, par période |

Portée : `sms:read`. Sans `sms:send`, les numéros lus dans l’historique sont masqués (`+22177•••4567`).

Plutôt que d’interroger ces routes en boucle, abonnez-vous aux [webhooks](https://docs.dexnotify.com/webhooks.md) `sms.sent`, `sms.delivered`, `sms.failed` et `sms.message.completed`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.