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.

{
  "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

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

CLI : keenauth email-sender-domains list