Listar dominios remitentes de correo electrónico

GET /v1/email-sender-domains · permiso email-sender-domains:read · todos los planes

Lista los dominios remitentes de correo electrónico del entorno, del más antiguo al más reciente. Un entorno tiene como máximo 10 dominios remitentes, por lo que la lista no está paginada: list_metadata.before y list_metadata.after siempre son null. Los dominios remitentes solo existen en entornos production; en otros entornos la lista está vacía.

Sin parámetros de solicitud ni cuerpo.

Respuesta

200 OK con todos los dominios remitentes del entorno. Cada elemento tiene los campos descritos en Obtener un dominio remitente de correo electrónico.

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

Errores

Ejemplo

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

CLI: keenauth email-sender-domains list