# Verificar uma lista

> Verifique até 10.000 endereços de e-mail de uma vez colando-os ou enviando um arquivo CSV ou XLSX, acompanhe o progresso, revise os resultados e exporte-os em XLSX.

Uma lista de verificação confere muitos endereços de uma só vez, por exemplo antes de importar contatos de outro sistema ou de enviar uma campanha para uma lista antiga. Este guia mostra como criar uma lista, acompanhar o progresso, ler os resultados e exportá-los.

## Antes de começar

- Uma lista pode conter até 10.000 endereços. Divida arquivos maiores em várias listas.
- Cada endereço único custa 5 créditos, cobrados quando você cria a lista. Uma lista de 10.000 endereços precisa de 50.000 créditos.
- As listas sempre usam o modo `full`, que inclui a verificação da caixa de e-mail. Consulte [Modos fast e full](/pt/docs/email-verification/single/#fast-and-full-mode).
- Para a API, use uma chave de API com **Full Access**.

## Criar uma lista

**Painel**

  1. **Abra Lists.** Acesse **Email Verification → Lists** e selecione **Verify emails**.

  2. **Dê um nome à lista.** Em **Name**, digite algo que você vai reconhecer depois, como `Newsletter import October`.

  3. **Adicione os endereços.** Em **Input Method**, escolha uma opção:

     - **Enter emails manually:** cole os endereços em **Email Addresses**, separados por vírgulas, ponto e vírgula ou quebras de linha.
     - **Upload a file:** escolha um arquivo `.csv` ou `.xlsx` com menos de 10 MB. Em um CSV, coloque um endereço por linha ou separe-os com vírgulas. No Excel, coloque-os na primeira coluna, um por linha. A caixa de diálogo mostra quantos endereços encontrou.

  4. **Selecione Create.** O Emailit cobra os créditos e começa a verificação.

**API**

  Chame [Criar uma lista](/pt/docs/api-reference/email-verifications/lists/create/) com um nome e um array de endereços:

```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"]
  }'
```

  A resposta `201` descreve a nova 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
}
```

  | Status | Quando |
  | --- | --- |
  | `201` | A lista foi criada e a verificação começou. |
  | `400` | `name` está ausente, `emails` está vazio, tem mais de 10.000 itens ou nenhum deles parece um endereço de e-mail. |
  | `402` | O workspace não tem créditos suficientes para todos os endereços únicos. |

Antes de cobrar, o Emailit limpa a entrada: converte todos os endereços para minúsculas, remove as duplicatas e descarta as entradas sem `@`. Você só é cobrado pelos endereços únicos que restarem. Se a lista não puder ser iniciada, os créditos são devolvidos.

## Acompanhar o progresso

O status da lista passa por estas etapas:

| Status | Significado |
| --- | --- |
| `pending` | Criada, aguardando o início. |
| `processing` | Os endereços estão sendo verificados. |
| `completed` | Todos os endereços têm um resultado. |
| `failed` | A lista não pôde ser processada. |
| `canceled` | A verificação foi interrompida. |

Em **Email Verification → Lists**, a coluna **Statistics** mostra as contagens **Total**, **Pending**, **Successful** e **Failed** de cada lista. A coluna **Expiring** mostra quantos dias faltam até a lista ser excluída.

Pela API, chame [Obter uma lista](/pt/docs/api-reference/email-verifications/lists/get/) e leia `status` e `stats`. Para não precisar consultar periodicamente, inscreva um [webhook](/pt/docs/webhooks/set-up/) em `email_verification_list.updated`, que é disparado quando a lista é concluída. Cada endereço também dispara `email_verification.updated` quando o resultado dele fica pronto.

## Revisar os resultados

Selecione uma lista no painel para abri-la. A página mostra:

- cards com **Created**, **Status**, **Total Emails**, **Pending**, **Successful** e **Failed**,
- gráficos de **Verification Status Progress**, **Verification Results Breakdown** e **Risk Levels**,
- uma tabela com todos os endereços, com status, resultado, risco e pontuação.

Pela API, chame [Listar resultados](/pt/docs/api-reference/email-verifications/lists/results/). Filtre por `result` ou `status` e pagine com `page` e `limit` (padrão 50):

```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 item tem `id`, `email`, `status`, `result`, `score`, `risk` e `mx_records` do endereço. [Resultados da verificação](/pt/docs/email-verification/results/) explica cada valor e o que fazer com ele.

## Exportar os resultados

Quando uma lista estiver `completed`, você pode baixar todos os resultados dela como um arquivo do Excel.

**Painel**

  Abra a lista e selecione **Export Results**. O Emailit baixa um arquivo `.xlsx` com o ID da lista como nome.

**API**

  Chame [Exportar resultados](/pt/docs/api-reference/email-verifications/lists/export/) e salve a resposta:

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

  Exportar uma lista que não foi concluída retorna `400`.

O arquivo tem uma linha por endereço, com status, resultado, pontuação e risco, cada verificação individual (sintaxe válida, descartável, endereço genérico, caixa cheia, entregável, desativado, e-mail gratuito, aleatório, catch-all, conexão SMTP, registros MX), as partes do endereço, a idade do domínio, a sugestão `did_you_mean` e os registros MX. Os resultados têm cores diferentes para você analisá-los rapidamente.

> **As listas são excluídas após 30 dias:** As listas de verificação e os resultados delas são excluídos 30 dias depois de criados. Exporte o arquivo se precisar guardar os resultados por mais tempo.

## Usar os resultados

1. **Remova** os endereços com o resultado `invalid`, `disabled` ou `disposable` antes de importar ou enviar.
2. **Revise** os endereços `inbox_full`, `role` e `unknown`. Mantenha-os se tiver um motivo para isso, mas acompanhe os bounces deles.
3. **Importe** o restante para os seus [contatos](/pt/docs/contacts/import-export/) ou para uma lista de contatos.

Consulte [Ações recomendadas](/pt/docs/email-verification/results/#recommended-actions) para cada resultado.

## Veja também

  - [Resultados da verificação](/pt/docs/email-verification/results/): Cada resultado, nível de risco e verificação.
  - [API de listas de verificação](/pt/docs/api-reference/email-verifications/lists/): Crie listas e leia os resultados pelo código.

---
Fonte: https://emailit.com/pt/docs/email-verification/lists/