API de vérification d’e-mails.

Vérifiez une adresse ou une liste de 100 000 au maximum via REST et récupérez un statut, une raison et une action pour chacune, en ne payant que les réponses définitives.

curl -X POST https://api.unspam.email/ext/v2/email-verification/instant-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "jane@acme.com" }'

# interrogez l’id jusqu’à la fin de la vérification
curl https://api.unspam.email/ext/v2/email-verification/instant-checks/8d3f1a2b \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# réponse (200)
{
  "status": "completed",
  "charged": true,
  "result": {
    "status": "deliverable",
    "reason": "accepted",
    "action": "keep",
    "flags": ["free_provider"],
    "did_you_mean": null
  }
}
curl -X POST https://api.unspam.email/ext/v2/email-verification/list-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -F "file=@leads.csv"

# la liste est analysée, puis vérifiée : lisez-la pour suivre la progression
curl https://api.unspam.email/ext/v2/email-verification/list-checks/5c2e9f10 \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# réponse (200)
{
  "status": "verifying",
  "rows_total": 12480,
  "duplicates": 311,
  "progress": { "processed": 4200, "total": 12046 }
}

# une fois terminée, parcourez chaque adresse dans l’ordre d’envoi
curl https://api.unspam.email/ext/v2/email-verification/list-checks/5c2e9f10/results \
  -H "Authorization: Bearer $UNSPAM_TOKEN"
Endpoints
5
Adresses par liste
100 000
Authentification
Token bearer
Limite de requêtes
100 par minute

Ce que l’API vérifie sur chaque adresse.

Syntaxe, domaine et serveur de messagerie

Chaque adresse est analysée, son domaine résolu et ses enregistrements MX lus : les fautes de frappe et les domaines qui ne reçoivent plus de courrier sont donc repérés avant même d’interroger une boîte.

Boîte, catch-all et boîte pleine

Le serveur de messagerie est interrogé sur l’existence de la boîte, sans envoyer de message. Les domaines catch-all, les boîtes pleines et les boîtes désactivées reviennent chacun avec leur propre raison.

Jetables, génériques et fournisseurs gratuits

Des indicateurs signalent les domaines jetables, les adresses génériques comme info@ et sales@ et les fournisseurs gratuits : votre code décide ainsi comment traiter chacune.

Suggestions en cas de faute de frappe

Quand une adresse ressemble à une faute de frappe, did_you_mean contient celle qui était probablement voulue, par exemple jane@gmail.com pour jane@gmial.com.

Une adresse, une liste entière ou un assistant IA.

Deux accès via REST et un via MCP, tous avec le même token et le même moteur de vérification.

Vérifier une seule adresse

Envoyez une adresse et recevez aussitôt un id. Interrogez-le jusqu’à ce que son statut soit completed ou failed, puis agissez selon le résultat : livrable, à risque, non livrable ou inconnu, avec une raison, une action et le détail du domaine, du serveur de messagerie et de la boîte sur lequel il repose.

La vérification est asynchrone : elle convient là où une courte attente ne gêne pas, comme un contact avant son entrée dans votre CRM, un lead avant une séquence ou une adresse avant un envoi ponctuel. Ce n’est pas une vérification synchrone qui bloque un formulaire d’inscription jusqu’à sa réponse.

  • jane@acme.com accepted
  • sales@northwind.io catch_all
  • lead@oldco.invalid invalid_domain
  • mark@yahoo.com provider_unverifiable

Vérifier une liste entière

Envoyez jusqu’à 100 000 adresses en JSON, ou importez un fichier CSV ou TXT de 20 Mo maximum et laissez l’API trouver la colonne des adresses et la ligne d’en-tête. Les doublons et les lignes mal formées sont comptés et ignorés, jamais facturés, et une liste que vos crédits ne couvrent pas est refusée avant qu’une seule vérification ne démarre.

Suivez la progression sur la liste elle-même jusqu’à ce qu’elle finisse en completed, failed, cancelled ou expired, puis parcourez page par page tous les résultats dans l’ordre d’envoi. Les listes et leurs résultats sont supprimés 30 jours après l’import.

  • Livrable 10 512
  • À risque 842
  • Non livrable 415
  • Inconnu, non facturé 277

Confiez-la à un assistant IA

Les mêmes vérifications sont des outils du serveur MCP d’Unspam : Claude, Cursor ou n’importe quel client MCP distant peut donc vérifier une adresse ou une liste depuis une conversation et restituer chaque résultat avec sa raison.

Cinq outils : verify_email, get_email_verification, create_email_list, get_email_list et get_email_list_results.

  • Vérifiez une adresse verify_email
  • Vérifiez une liste create_email_list
  • Lisez les résultats get_email_list_results

Ce que chaque résultat vous apprend.

Quatre champs portent la réponse : votre code décide sur une seule valeur et dispose quand même du détail quand il en a besoin.

  1. 01

    status

    Livrable, à risque, non livrable ou inconnu : le seul champ sur lequel décider.

  2. 02

    reason

    Pourquoi ce statut : accepted, catch_all, full_inbox, disposable, invalid_syntax, invalid_domain, rejected, disabled, timeout, smtp_unavailable, provider_unverifiable ou unknown.

  3. 03

    action

    Conserver, examiner, supprimer ou réessayer : vous n’avez pas à associer vous-même chaque raison à une décision.

  4. 04

    charged

    Si la vérification a consommé un crédit. Les réponses inconnues, les doublons et les adresses mal formées n’en consomment jamais.

Les endpoints derrière.

5 endpoints, avec le même token que le reste de l’API. Le document OpenAPI détaille chaque paramètre et code de réponse.

Document OpenAPI
Email Verification 5 appels
  • POST /email-verification/instant-checks
  • GET /email-verification/instant-checks/{id}
  • POST /email-verification/list-checks
  • GET /email-verification/list-checks/{id}
  • GET /email-verification/list-checks/{id}/results

Questions sur l’API de vérification d’e-mails.

Tarifs, rapidité, résultats inconnus, listes et assistants IA.

Combien coûte l’API de vérification d’e-mails ?
L’accès à l’API est inclus dans le plan sur mesure, à partir d’un minimum de $5 par mois. La vérification est tarifée par tranche, de $6,40 pour 1 000 adresses jusqu’à $1,20 pour 1 000 au-delà de 100 000, et seules les réponses définitives consomment un crédit. Les réponses inconnues, les doublons et les adresses mal formées sont gratuits, et vous pouvez recharger des crédits sans changer de plan.
Existe-t-il une API de vérification d’e-mails gratuite ?
Les 10 premières vérifications unitaires de chaque jour sont gratuites, via l’API comme dans l’application, et une réponse inconnue n’est jamais facturée. Pour essayer sans compte, le vérificateur d’e-mails vérifie jusqu’à 10 adresses par jour sans inscription.
L’API de vérification d’e-mails fonctionne-t-elle en temps réel ?
Elle est asynchrone. Une vérification démarre aussitôt et répond avec un id, et vous lisez le résultat quand son statut est completed, ou vous arrêtez s’il est failed. Cela convient aux imports, aux synchronisations de CRM, au routage des leads et au nettoyage de listes. Une vérification synchrone qui bloque un formulaire d’inscription jusqu’à sa réponse n’est pas proposée aujourd’hui.
Quelle différence entre validation et vérification d’e-mail ?
La validation consiste généralement à contrôler qu’une adresse est bien formée et que son domaine peut recevoir du courrier. La vérification va plus loin et demande au serveur de messagerie si la boîte existe. L’API fait les deux en un seul appel : d’abord la syntaxe, le domaine et le MX, puis les contrôles de boîte, de catch-all et de boîte pleine.
Pourquoi certaines adresses reviennent-elles inconnues ?
Yahoo et AOL acceptent toutes les adresses lors d’une vérification de boîte : aucun vérificateur ne peut donc confirmer ces boîtes, qui reviennent inconnues avec la raison provider_unverifiable. Un serveur de messagerie qui expire ou ne répond pas aboutit aussi à un résultat inconnu, avec la raison timeout ou smtp_unavailable et l’action retry. Les réponses inconnues ne sont jamais facturées.
Comment vérifier une liste entière via l’API ?
Envoyez les adresses sous forme de tableau JSON, ou importez un fichier CSV ou TXT de 100 000 lignes et 20 Mo maximum. L’API trouve la colonne des adresses et la ligne d’en-tête, compte les doublons et les lignes mal formées sans les facturer, et lance la vérification une fois la liste analysée. Interrogez la liste pour suivre la progression et obtenir une synthèse, puis parcourez les résultats page par page.
Un assistant IA peut-il vérifier des adresses e-mail avec Unspam ?
Oui. Le serveur MCP d’Unspam expose la vérification sous forme de cinq outils : Claude, Cursor ou n’importe quel client MCP distant peut donc vérifier une adresse ou une liste entière et restituer chaque résultat avec sa raison et son action.
Les données des listes sont-elles conservées ?
Les listes et leurs résultats sont supprimés 30 jours après l’import, après quoi l’endpoint des résultats répond 410 Gone. Les adresses sont vérifiées auprès du serveur de messagerie sans envoyer de message à quiconque.

Vérifiez votre première liste via l’API.

L’accès à l’API est inclus dans le plan sur mesure, à partir d’un minimum de $5 par mois. Ne payez que les réponses définitives, à partir de $6,40 pour 1 000 adresses.