# Verifica una lista

> Verifica fino a 10.000 indirizzi email in una volta incollandoli o caricando un file CSV o XLSX, segui l’avanzamento, controlla gli esiti ed esportali in XLSX.

Una lista di verifica controlla molti indirizzi in una sola volta, ad esempio prima di importare contatti da un altro sistema o di inviare una campagna a una lista datata. Questa guida mostra come creare una lista, seguirne l’avanzamento, leggerne gli esiti ed esportarli.

## Prima di iniziare

- Una lista può contenere fino a 10.000 indirizzi. Dividi i file più grandi in più liste.
- Ogni indirizzo unico costa 5 crediti, addebitati quando crei la lista. Una lista di 10.000 indirizzi richiede 50.000 crediti.
- Le liste usano sempre la modalità `full`, che include il controllo della casella. Vedi [Modalità rapida e completa](/it/docs/email-verification/single/#fast-and-full-mode).
- Per l’API, usa una chiave API con **Full Access**.

## Crea una lista

**Pannello**

  1. **Apri Lists.** Vai a **Email Verification → Lists** e seleziona **Verify emails**.

  2. **Dai un nome alla lista.** In **Name**, inserisci un nome che riconoscerai in seguito, ad esempio `Newsletter import October`.

  3. **Aggiungi gli indirizzi.** In **Input Method**, scegli uno dei due metodi:

     - **Enter emails manually:** incolla gli indirizzi in **Email Addresses**, separati da virgole, punti e virgola o a capo.
     - **Upload a file:** scegli un file `.csv` o `.xlsx` più piccolo di 10 MB. In un CSV, metti un indirizzo per riga o separali con virgole. In Excel, mettili nella prima colonna, uno per riga. La finestra mostra quanti indirizzi ha trovato.

  4. **Seleziona Create.** Emailit addebita i crediti e avvia la verifica.

**API**

  Chiama [Crea una lista](/it/docs/api-reference/email-verifications/lists/create/) con un nome e un array di indirizzi:

```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 risposta `201` descrive la nuova 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
}
```

  | Stato | Quando |
  | --- | --- |
  | `201` | La lista è stata creata e la verifica è partita. |
  | `400` | Manca `name`, `emails` è vuoto, contiene più di 10.000 elementi oppure nessuno di essi sembra un indirizzo email. |
  | `402` | Il workspace non ha abbastanza crediti per tutti gli indirizzi unici. |

Prima di addebitare, Emailit ripulisce l’input: converte ogni indirizzo in minuscolo, rimuove i duplicati e scarta le voci senza `@`. Ti vengono addebitati solo gli indirizzi unici rimasti. Se la lista non può essere avviata, i crediti vengono rimborsati.

## Segui l’avanzamento

Lo stato della lista attraversa queste fasi:

| Stato | Significato |
| --- | --- |
| `pending` | Creata, in attesa di avvio. |
| `processing` | Gli indirizzi sono in corso di verifica. |
| `completed` | Ogni indirizzo ha un esito. |
| `failed` | Non è stato possibile elaborare la lista. |
| `canceled` | La verifica è stata interrotta. |

In **Email Verification → Lists**, la colonna **Statistics** mostra i conteggi **Total**, **Pending**, **Successful** e **Failed** di ogni lista. La colonna **Expiring** mostra quanti giorni mancano all’eliminazione della lista.

Con l’API, chiama [Recupera una lista](/it/docs/api-reference/email-verifications/lists/get/) e leggi `status` e `stats`. Per evitare il polling, iscrivi un [webhook](/it/docs/webhooks/set-up/) a `email_verification_list.updated`, che viene generato quando la lista è completata. Ogni indirizzo genera anche `email_verification.updated` quando il suo esito è pronto.

## Controlla gli esiti

Seleziona una lista nel pannello per aprirla. La pagina mostra:

- i riquadri **Created**, **Status**, **Total Emails**, **Pending**, **Successful** e **Failed**,
- i grafici **Verification Status Progress**, **Verification Results Breakdown** e **Risk Levels**,
- una tabella con ogni indirizzo, con stato, esito, rischio e punteggio.

Con l’API, chiama [Elenca gli esiti](/it/docs/api-reference/email-verifications/lists/results/). Filtra per `result` o `status` e scorri le pagine con `page` e `limit` (predefinito 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"
```

Ogni elemento contiene `id`, `email`, `status`, `result`, `score`, `risk` e `mx_records` dell’indirizzo. [Esiti della verifica](/it/docs/email-verification/results/) spiega ogni valore e cosa farne.

## Esporta gli esiti

Quando una lista è `completed`, puoi scaricarne tutti gli esiti come file Excel.

**Pannello**

  Apri la lista e seleziona **Export Results**. Emailit scarica un file `.xlsx` con il nome dell’ID della lista.

**API**

  Chiama [Esporta gli esiti](/it/docs/api-reference/email-verifications/lists/export/) e salva la risposta:

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

  Esportare una lista non completata restituisce `400`.

Il file ha una riga per indirizzo con stato, esito, punteggio e rischio, ogni singolo controllo (sintassi valida, usa e getta, indirizzo di ruolo, casella piena, consegnabile, disattivato, email gratuita, casuale, catch-all, connessione SMTP, record MX), le parti dell’indirizzo, l’età del dominio, il suggerimento `did_you_mean` e i record MX. Gli esiti sono evidenziati con colori diversi per poterli scorrere rapidamente.

> **Le liste vengono eliminate dopo 30 giorni:** Le liste di verifica e i loro esiti vengono eliminati 30 giorni dopo la creazione. Esporta il file se devi conservare gli esiti più a lungo.

## Usa gli esiti

1. **Rimuovi** gli indirizzi con esito `invalid`, `disabled` o `disposable` prima di importare o inviare.
2. **Controlla** gli indirizzi `inbox_full`, `role` e `unknown`. Tienili se hai un motivo per farlo, ma tieni d’occhio i loro bounce.
3. **Importa** il resto nei [contatti](/it/docs/contacts/import-export/) o in una lista.

Per ogni esito, vedi [Azioni consigliate](/it/docs/email-verification/results/#recommended-actions).

## Vedi anche

  - [Esiti della verifica](/it/docs/email-verification/results/): Ogni esito, livello di rischio e controllo.
  - [API delle liste di verifica](/it/docs/api-reference/email-verifications/lists/): Crea liste e leggi gli esiti dal codice.

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