Récupérer un domaine d'envoi d'e-mails

GET /v1/email-sender-domains/{sender_domain_id} · autorisation email-sender-domains:read · tous les forfaits

Renvoie un domaine d'envoi : son statut, les résultats de la dernière vérification DNS et les enregistrements DNS à publier. L'en-tête ETag contient la version ; envoyez-la dans If-Match lorsque vous supprimez le domaine.

Requête

Champ Type Requis Description
sender_domain_id string oui Identifiant du domaine d'envoi (sdom_…).

Aucun corps de requête.

Réponse

200 OK avec le domaine d'envoi et ETag défini sur sa version.

Champ Type Description
id string Identifiant du domaine d'envoi (sdom_…).
domain string Le domaine sous forme de A-label IDNA 2008, en minuscules, sans point final.
status string pending_dns (en attente des enregistrements DNS), verified (prêt à envoyer), degraded (les enregistrements échouent depuis 72 heures ; l'environnement est revenu à l'envoi de la plateforme) ou disabled (désactivé par la plateforme).
active_selector string Sélecteur DKIM utilisé pour la signature : akp1 ou akp2.
dkim_status string or null Dernière vérification des deux CNAME DKIM (le pire des deux) : ok, missing, wrong_target ou lookup_failed ; null avant la première vérification.
return_path_status string or null Dernière vérification du CNAME return-path, mêmes codes ; null avant la première vérification.
dmarc_alignment string or null Résultat DMARC de la dernière vérification : aligned, not_aligned, no_record, invalid_record ou lookup_failed. DMARC n'est pas obligatoire.
last_checked_at string or null Date de la dernière vérification.
failing_since string or null Première vérification échouée d'un domaine verified ; à 72 heures, le domaine passe à degraded.
degraded_since string or null Date à laquelle le domaine est passé à degraded.
records array Enregistrements DNS à publier : type (CNAME ou TXT), name, value et required. Les deux CNAME DKIM et le CNAME return-path sont obligatoires ; lorsque la dernière vérification n'a trouvé aucun enregistrement _dmarc, une suggestion DMARC (v=DMARC1; p=none) est ajoutée avec required: false.
version integer Version du domaine, identique à l'ETag ; elle augmente à chaque écriture, vérifications comprises.
created_at string Date de création.
updated_at string Date de la dernière modification. 
{
  "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"
}

Erreurs

HTTP code Quand
404 not_found Le domaine d'envoi n'existe pas, appartient à un autre environnement ou l'identifiant est mal formé.
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/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth email-sender-domains get sdom_01k7r9m3q5t8v2w4x6y8z0a2b4