# Lister les domaines d'envoi d'e-mails

`GET /v1/email-sender-domains` · autorisation `email-sender-domains:read` · tous les forfaits

Liste les domaines d'envoi d'e-mails de l'environnement, du plus ancien au plus récent. Un environnement compte au maximum 10 domaines d'envoi, la liste n'est donc pas paginée : `list_metadata.before` et `list_metadata.after` valent toujours null. Les domaines d'envoi n'existent que dans les environnements `production` ; dans les autres environnements, la liste est vide.

Aucun paramètre de requête ni corps.

## Réponse

`200 OK` avec tous les domaines d'envoi de l'environnement. Chaque élément contient les champs décrits dans [Récupérer un domaine d'envoi d'e-mails](get.md).

```json
{
  "data": [
    {
      "id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
      "domain": "mail.example.com",
      "status": "pending_dns",
      "active_selector": "akp1",
      "dkim_status": null,
      "return_path_status": null,
      "dmarc_alignment": null,
      "last_checked_at": null,
      "failing_since": null,
      "degraded_since": null,
      "records": [
        {
          "type": "CNAME",
          "name": "akp1._domainkey.mail.example.com",
          "value": "akp1.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
          "required": true
        },
        {
          "type": "CNAME",
          "name": "akp2._domainkey.mail.example.com",
          "value": "akp2.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
          "required": true
        },
        {
          "type": "CNAME",
          "name": "rp.mail.example.com",
          "value": "rp.eu.mail.keenauth.app",
          "required": true
        }
      ],
      "version": 1,
      "created_at": "2026-10-19T09:00:00Z",
      "updated_at": "2026-10-19T09:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 401 | `unauthenticated` | L'identifiant est absent, invalide ou révoqué. |
| 403 | `insufficient_permissions` | L'identifiant ne dispose pas de l'autorisation requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la période indiquée par `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la période indiquée par `Retry-After`. |

## Exemple

```bash
curl https://api.eu.keenauth.com/v1/email-sender-domains \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI : `keenauth email-sender-domains list`