# 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](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
  }
}
```

## Errores

| HTTP | código | Cuándo |
|---|---|---|
| 401 | `unauthenticated` | La credencial falta, no es válida o fue revocada. |
| 403 | `insufficient_permissions` | La credencial no tiene el permiso requerido. |
| 429 | `rate_limited` | Se superó el límite de frecuencia; reintente después del período `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente después del período `Retry-After`. |

## Ejemplo

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

CLI: `keenauth email-sender-domains list`