# Verificar una lista

> Verifica hasta 10.000 direcciones de email a la vez pegándolas o subiendo un archivo CSV o XLSX, sigue el progreso, revisa los resultados y expórtalos en XLSX.

Una lista de direcciones comprueba muchas direcciones de una vez, por ejemplo antes de importar contactos de otro sistema o de enviar una campaña a una lista antigua. Esta guía explica cómo crear una lista, seguir su progreso, leer los resultados y exportarlos.

## Antes de empezar

- Una lista puede contener hasta 10.000 direcciones. Divide los archivos más grandes en varias listas.
- Cada dirección única cuesta 5 créditos, que se cobran al crear la lista. Una lista de 10.000 direcciones necesita 50.000 créditos.
- Las listas siempre usan el modo `full`, que incluye la comprobación del buzón. Consulta [Modo rápido y modo completo](/es/docs/email-verification/single/#fast-and-full-mode).
- Para la API, usa una clave de API con **Full Access**.

## Crear una lista

**Panel**

  1. **Abre Lists.** Ve a **Email Verification → Lists** y selecciona **Verify emails**.

  2. **Ponle nombre a la lista.** En **Name**, introduce algo que reconozcas más adelante, como `Newsletter import October`.

  3. **Añade las direcciones.** En **Input Method**, elige una opción:

     - **Enter emails manually:** pega las direcciones en **Email Addresses**, separadas por comas, puntos y comas o saltos de línea.
     - **Upload a file:** elige un archivo `.csv` o `.xlsx` de menos de 10 MB. En un CSV, pon una dirección por fila o sepáralas con comas. En Excel, ponlas en la primera columna, una por fila. El cuadro de diálogo muestra cuántas direcciones ha encontrado.

  4. **Selecciona Create.** Emailit cobra los créditos y empieza la verificación.

**API**

  Llama a [Crear una lista](/es/docs/api-reference/email-verifications/lists/create/) con un nombre y un array de direcciones:

```bash
curl https://api.emailit.com/v2/email-verification-lists \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter import October",
    "emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
  }'
```

  La respuesta `201` describe la nueva lista:

```json
{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}
```

  | Estado | Cuándo |
  | --- | --- |
  | `201` | La lista se ha creado y la verificación ha empezado. |
  | `400` | Falta `name`, `emails` está vacío, tiene más de 10.000 elementos o ninguno parece una dirección de email. |
  | `402` | El espacio de trabajo no tiene créditos suficientes para todas las direcciones únicas. |

Antes de cobrar, Emailit limpia los datos de entrada: pasa todas las direcciones a minúsculas, elimina los duplicados y descarta las entradas sin `@`. Solo se te cobran las direcciones únicas que quedan. Si la lista no se puede iniciar, se devuelven los créditos.

## Seguir el progreso

El estado de la lista pasa por estas etapas:

| Estado | Significado |
| --- | --- |
| `pending` | Creada, a la espera de empezar. |
| `processing` | Se están verificando las direcciones. |
| `completed` | Todas las direcciones tienen un resultado. |
| `failed` | No se ha podido procesar la lista. |
| `canceled` | Se ha detenido la verificación. |

En **Email Verification → Lists**, la columna **Statistics** muestra los recuentos **Total**, **Pending**, **Successful** y **Failed** de cada lista. La columna **Expiring** muestra cuántos días quedan hasta que se elimine la lista.

Con la API, llama a [Obtener una lista](/es/docs/api-reference/email-verifications/lists/get/) y lee `status` y `stats`. Para no tener que consultarla periódicamente, suscribe un [webhook](/es/docs/webhooks/set-up/) a `email_verification_list.updated`, que se dispara cuando la lista termina. Cada dirección también dispara `email_verification.updated` cuando su resultado está listo.

## Revisar los resultados

Selecciona una lista en el panel para abrirla. La página muestra:

- tarjetas con **Created**, **Status**, **Total Emails**, **Pending**, **Successful** y **Failed**,
- gráficos de **Verification Status Progress**, **Verification Results Breakdown** y **Risk Levels**,
- una tabla con todas las direcciones, con su estado, resultado, riesgo y puntuación.

Con la API, llama a [Listar los resultados](/es/docs/api-reference/email-verifications/lists/results/). Filtra por `result` o `status` y recorre las páginas con `page` y `limit` (50 por defecto):

```bash
curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"
```

Cada elemento tiene el `id`, `email`, `status`, `result`, `score`, `risk` y `mx_records` de la dirección. [Resultados de la verificación](/es/docs/email-verification/results/) explica cada valor y qué hacer con él.

## Exportar los resultados

Cuando una lista está `completed`, puedes descargar todos sus resultados como archivo de Excel.

**Panel**

  Abre la lista y selecciona **Export Results**. Emailit descarga un archivo `.xlsx` con el ID de la lista como nombre.

**API**

  Llama a [Exportar los resultados](/es/docs/api-reference/email-verifications/lists/export/) y guarda la respuesta:

```bash
curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx
```

  Exportar una lista que no está completada devuelve `400`.

El archivo tiene una fila por dirección con su estado, resultado, puntuación y riesgo, cada comprobación individual (sintaxis válida, desechable, dirección de rol, buzón lleno, entregable, desactivada, email gratuito, aleatoria, catch-all, conexión SMTP, registros MX), las partes de la dirección, la antigüedad del dominio, la sugerencia `did_you_mean` y los registros MX. Los resultados tienen colores para que puedas revisarlos de un vistazo.

> **Las listas se eliminan a los 30 días:** Las listas de direcciones y sus resultados se eliminan 30 días después de crearlas. Exporta el archivo si necesitas conservar los resultados más tiempo.

## Usar los resultados

1. **Elimina** las direcciones con el resultado `invalid`, `disabled` o `disposable` antes de importar o enviar.
2. **Revisa** las direcciones `inbox_full`, `role` y `unknown`. Consérvalas si tienes un motivo, pero vigila sus rebotes.
3. **Importa** el resto en tus [contactos](/es/docs/contacts/import-export/) o en una lista de contactos.

Consulta las [acciones recomendadas](/es/docs/email-verification/results/#recommended-actions) para cada resultado.

## Ver también

  - [Resultados de la verificación](/es/docs/email-verification/results/): Cada resultado, nivel de riesgo y comprobación.
  - [API de listas de direcciones](/es/docs/api-reference/email-verifications/lists/): Crea listas y lee los resultados desde el código.

---
Fuente: https://emailit.com/es/docs/email-verification/lists/