> ## 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.

# Suivi et suppressions

> Ce qu’il advient de chaque e-mail, et les adresses à ne plus viser.

## Statuts

| Statut | Sens |
| - | - |
| `queued` | accepté, en file |
| `sent` | remis au serveur d’envoi |
| `delivered` | accepté par la messagerie du destinataire |
| `bounced` | rebond : adresse inexistante ou boîte pleine |
| `complained` | le destinataire l’a signalé comme indésirable |
| `rejected`, `failed` | refusé avant l’envoi |
| `suppressed` | toutes les adresses étaient sur la liste de suppression |

```bash theme={null}
curl "https://api.dexnotify.com/api/v1/email/messages/6731…" -H "x-api-key: $DEXNOTIFY_CLE"
```

Le détail rend aussi la chronologie des **événements** : `send`, `delivery`, `bounce`, `complaint`, `reject`, `open`, `click`, `delivery_delay`, `rendering_failure`. Le journal (`GET /api/v1/email/messages`) se filtre par statut et par destinataire.

Portée : `email:read`.

## Liste de suppression

Une adresse qui rebondit définitivement ou qui se plaint est **ajoutée d’elle-même** à la liste de suppression de l’organisation : plus aucun e-mail ne lui part, pour protéger la réputation de vos domaines.

| Route | Effet |
| - | - |
| `GET /api/v1/email/suppressions` | les adresses écartées, avec leur motif (`bounce`, `complaint`, `manual`) |
| `POST /api/v1/email/suppressions` | ajoute une adresse (`manual`) |
| `DELETE /api/v1/email/suppressions/{email}` | retire une adresse — à faire seulement si la personne vous l’a demandé |

> [!NOTE]
>
> La désinscription d’une **campagne** est distincte : elle passe le contact en `unsubscribed` pour l’e-mail marketing, sans l’empêcher de recevoir vos e-mails transactionnels. Voir [Désinscription](https://docs.dexnotify.com/campagnes/desabonnement.md).


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