API de vérification d’e-mails.

Vérifiez une adresse ou une liste entière, jusqu’à 100 000 adresses, via une API REST. Chaque adresse revient avec un statut, la raison de ce statut et l’action à mener, et vous ne payez que les réponses définitives : les inconnues, les doublons et les adresses mal formées sont gratuits. Les mêmes vérifications sont exposées comme outils MCP : un assistant IA peut donc vérifier une liste à votre place.

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

# response (202): read it by id until completed
curl https://api.unspam.email/ext/v2/email-verification/instant-checks/8d3f1a2b \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (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"

# response (202): the list is analysed, then verified
{
  "status": "verifying",
  "rows_total": 12480,
  "duplicates": 311,
  "progress": { "processed": 4200, "total": 12046 }
}

# then page through every address, in the order sent
curl https://api.unspam.email/ext/v2/email-verification/list-checks/5c2e9f10/results \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

Cinq endpoints, un seul token.

URL de base https://api.unspam.email/ext/v2, avec le bearer token de votre compte. C’est le même token que celui des API de test de spam, de placement en boîte de réception et de prévisualisation.

Vérifier une adresse

POST /email-verification/instant-checksLance la vérification d’une adresse et répond 202 avec son id.

Lire le résultat

GET /email-verification/instant-checks/{id}Statut pending jusqu’à la fin de la vérification, puis le résultat complet.

Vérifier une liste

POST /email-verification/list-checksAdresses en JSON ou fichier CSV ou TXT, jusqu’à 100 000 lignes. La vérification démarre une fois la liste analysée.

Suivre la liste

GET /email-verification/list-checks/{id}Statut, compteurs, progression en cours d’exécution et synthèse par statut et par raison.

Parcourir les résultats

GET /email-verification/list-checks/{id}/resultsChaque adresse dans l’ordre d’envoi, avec son résultat complet. Répond 410 une fois la liste expirée.

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 gmail.com pour 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.

01

Vérifier une seule adresse

Envoyez une adresse et recevez aussitôt un id. Interrogez-le jusqu’à ce que son statut soit completed, 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
02

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, 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
03

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 ou provider_unverifiable.

  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.

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. 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.

Voir les tarifs