# Vérifier une liste

> Vérifiez jusqu’à 10 000 adresses e-mail en une fois en les collant ou en important un fichier CSV ou XLSX, suivez la progression, examinez les résultats et exportez-les en XLSX.

Une liste de vérification contrôle de nombreuses adresses d’un coup, par exemple avant d’importer des contacts depuis un autre système ou d’envoyer une campagne à une ancienne liste. Ce guide explique comment créer une liste, suivre sa progression, lire les résultats et les exporter.

## Avant de commencer

- Une liste peut contenir jusqu’à 10 000 adresses. Découpez les fichiers plus volumineux en plusieurs listes.
- Chaque adresse unique coûte 5 crédits, débités à la création de la liste. Une liste de 10 000 adresses nécessite 50 000 crédits.
- Les listes utilisent toujours le mode `full`, qui inclut le contrôle de la boîte aux lettres. Consultez [Mode rapide et mode complet](/fr/docs/email-verification/single/#fast-and-full-mode).
- Pour l’API, utilisez une clé API **Full Access**.

## Créer une liste

**Tableau de bord**

  1. **Ouvrez Lists.** Accédez à **Email Verification → Lists** et sélectionnez **Verify emails**.

  2. **Nommez la liste.** Dans **Name**, saisissez un nom que vous reconnaîtrez plus tard, comme `Newsletter import October`.

  3. **Ajoutez les adresses.** Sous **Input Method**, choisissez l’une des options :

     - **Enter emails manually** : collez les adresses dans **Email Addresses**, séparées par des virgules, des points-virgules ou des retours à la ligne.
     - **Upload a file** : choisissez un fichier `.csv` ou `.xlsx` de moins de 10 Mo. Dans un CSV, placez une adresse par ligne ou séparez-les par des virgules. Dans Excel, placez-les dans la première colonne, une par ligne. La boîte de dialogue indique le nombre d’adresses trouvées.

  4. **Sélectionnez Create.** Emailit débite les crédits et lance la vérification.

**API**

  Appelez [Créer une liste](/fr/docs/api-reference/email-verifications/lists/create/) avec un nom et un tableau d’adresses :

```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 réponse `201` décrit la nouvelle liste :

```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
}
```

  | Statut | Cas |
  | --- | --- |
  | `201` | La liste a été créée et la vérification a démarré. |
  | `400` | `name` est absent, `emails` est vide, contient plus de 10 000 éléments, ou aucun d’entre eux ne ressemble à une adresse e-mail. |
  | `402` | L’espace de travail n’a pas assez de crédits pour toutes les adresses uniques. |

Avant de débiter les crédits, Emailit nettoie les données saisies : il met chaque adresse en minuscules, supprime les doublons et écarte les entrées sans `@`. Seules les adresses uniques restantes sont facturées. Si la liste ne peut pas démarrer, les crédits sont remboursés.

## Suivre la progression

Le statut de la liste passe par ces étapes :

| Statut | Signification |
| --- | --- |
| `pending` | Créée, en attente de démarrage. |
| `processing` | Les adresses sont en cours de vérification. |
| `completed` | Chaque adresse a un résultat. |
| `failed` | La liste n’a pas pu être traitée. |
| `canceled` | La vérification a été arrêtée. |

Dans **Email Verification → Lists**, la colonne **Statistics** affiche pour chaque liste les compteurs **Total**, **Pending**, **Successful** et **Failed**. La colonne **Expiring** indique le nombre de jours restants avant la suppression de la liste.

Via l’API, appelez [Récupérer une liste](/fr/docs/api-reference/email-verifications/lists/get/) et lisez `status` et `stats`. Pour éviter d’interroger l’API en boucle, abonnez un [webhook](/fr/docs/webhooks/set-up/) à `email_verification_list.updated`, qui se déclenche à la fin de la liste. Chaque adresse déclenche aussi `email_verification.updated` quand son résultat est prêt.

## Examiner les résultats

Sélectionnez une liste dans le tableau de bord pour l’ouvrir. La page affiche :

- des cartes **Created**, **Status**, **Total Emails**, **Pending**, **Successful** et **Failed** ;
- des graphiques **Verification Status Progress**, **Verification Results Breakdown** et **Risk Levels** ;
- un tableau de toutes les adresses avec leur statut, leur résultat, leur risque et leur score.

Via l’API, appelez [Lister les résultats](/fr/docs/api-reference/email-verifications/lists/results/). Filtrez par `result` ou `status` et parcourez les pages avec `page` et `limit` (50 par défaut) :

```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"
```

Chaque élément contient les champs `id`, `email`, `status`, `result`, `score`, `risk` et `mx_records` de l’adresse. [Résultats de vérification](/fr/docs/email-verification/results/) explique chaque valeur et la marche à suivre.

## Exporter les résultats

Une fois la liste `completed`, vous pouvez télécharger tous ses résultats sous forme de fichier Excel.

**Tableau de bord**

  Ouvrez la liste et sélectionnez **Export Results**. Emailit télécharge un fichier `.xlsx` portant l’ID de la liste.

**API**

  Appelez [Exporter les résultats](/fr/docs/api-reference/email-verifications/lists/export/) et enregistrez la réponse :

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

  L’export d’une liste qui n’est pas terminée renvoie `400`.

Le fichier contient une ligne par adresse avec son statut, son résultat, son score et son risque, chaque contrôle individuel (syntaxe valide, adresse jetable, adresse générique, boîte pleine, livrable, désactivée, messagerie gratuite, charabia, catch-all, connexion SMTP, enregistrements MX), les parties de l’adresse, l’âge du domaine, la suggestion `did_you_mean` et les enregistrements MX. Les résultats sont codés par couleur pour une lecture rapide.

> **Les listes sont supprimées au bout de 30 jours:** Les listes de vérification et leurs résultats sont supprimés 30 jours après leur création. Exportez le fichier si vous devez conserver les résultats plus longtemps.

## Utiliser les résultats

1. **Retirez** les adresses dont le résultat est `invalid`, `disabled` ou `disposable` avant d’importer ou d’envoyer.
2. **Examinez** les adresses `inbox_full`, `role` et `unknown`. Conservez-les si vous avez une raison de le faire, mais surveillez leurs rebonds.
3. **Importez** le reste dans vos [contacts](/fr/docs/contacts/import-export/) ou dans une liste de contacts.

Pour chaque résultat, consultez [Actions recommandées](/fr/docs/email-verification/results/#recommended-actions).

## Voir aussi

  - [Résultats de vérification](/fr/docs/email-verification/results/): Chaque résultat, niveau de risque et contrôle.
  - [API des listes de vérification](/fr/docs/api-reference/email-verifications/lists/): Créez des listes et lisez les résultats depuis votre code.

---
Source: https://emailit.com/fr/docs/email-verification/lists/