Docs de l'API de validation des courriels

Pour commencer

Toutes les demandes d'API nécessitent une authentification à l'aide d'une clé API. Vous trouverez votre clé API dans le tableau de bord.

En-tête : "x-api-key : your-api-key"

Vérification unique

Vérifier la validité d'une adresse électronique ou d'un domaine, son caractère jetable, ses services de confidentialité et sa capacité à être délivrée.

Point final

GET /v1/verify

Paramètres

Nom	Type	Exigée	Description
input	string	Oui	Adresse électronique ou domaine à vérifier (par exemple, [email protected] ou example.com)

Champs de réponse

Champ d'application	Description
valid	Indique si le format du courrier électronique est correct
block	Indique si l'e-mail doit être bloqué (vrai si jetable, privacy, applePrivateEmail, deliverable ou catch_all est vrai).
disposable	Détermine si l'adresse électronique est temporaire ou jetable.
privacy	Détermine si le serveur de messagerie utilise un alias ou une redirection de courrier électronique.
applePrivateEmail	Indique si l'adresse électronique est une adresse privée Apple.
deliverable	Vérifie que la boîte aux lettres existe et qu'elle peut recevoir des courriels.
domain	La partie domaine de l'adresse électronique
email_address	L'adresse électronique
catch_all	Indique si le domaine dispose d'une configuration de courrier électronique attrape-tout qui accepte tous les courriels entrants quelle que soit l'adresse du destinataire
mx_found	Indique si le domaine possède des serveurs de messagerie valides (enregistrements MX)
remaining_credits	Le nombre de crédits API restant sur votre compte

Liste noire / liste blanche : Seul le champ bloc reflète l'appartenance à la liste. Liste noire → bloc : vrai ; liste blanche → bloc : faux ; pas dans la liste blanche (lorsqu'elle est activée) → bloc : vrai. N'utilisez pas valid pour décider de bloquer ou non en fonction des listes.

Exemple de réponse

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Exemples de codes

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Essayez-le

Clé API

Vous avez besoin d'une clé API pour tester les points d'extrémité.

Adresse e-mail ou domaine

Essayez avec :

Vérification des lots

Vérifier plusieurs adresses électroniques ou domaines en une seule demande (100 éléments au maximum).

Point final

POST /v1/verify/batch

Paramètres

Nom	Type	Exigée	Description
inputs	array of strings	Oui	Tableau d'adresses électroniques ou de domaines à vérifier

Exemples de codes

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Essayez-le

Clé API

Vous avez besoin d'une clé API pour tester les points d'extrémité.

Adresses e-mail ou domaines

Essayez avec différents domaines :

Contrôle des produits livrables uniquement

Vérification rapide de la délivrabilité des courriels à l'aide de la vérification MX et SMTP sans appel d'API externe. Ne renvoie que les champs liés à la délivrabilité pour des temps de réponse plus rapides.

Point final

GET /v1/verify/deliverable

Paramètres

Nom	Type	Exigée	Description
input	string	Oui	Adresse électronique pour vérifier la délivrabilité (par exemple, [email protected]). La saisie d'un domaine uniquement n'est pas prise en charge pour ce point d'accès.

Champs de réponse

Champ d'application	Description
valid	Indique si le format du courrier électronique est correct
deliverable	Vérifie que la boîte aux lettres existe et qu'elle peut recevoir des courriels.
mx_found	Indique si le domaine possède des serveurs de messagerie valides (enregistrements MX)
catch_all	Indique si le domaine dispose d'une configuration de courrier électronique attrape-tout qui accepte tous les courriels entrants quelle que soit l'adresse du destinataire
email_address	L'adresse électronique
remaining_credits	Le nombre de crédits API restant sur votre compte

Exemple de réponse

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "[email protected]",
  "remaining_credits": 99
}

Exemples de codes

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -H "X-API-Key: your-api-key"

Essayez-le

Clé API

Vous avez besoin d'une clé API pour tester les points d'extrémité.

Adresse e-mail ou domaine

Essayez avec :

Liste blanche et liste noire

Contrôlez quels e-mails et domaines sont bloqués grâce aux règles de liste noire et blanche par utilisateur. Ces listes définissent le champ block dans chaque réponse de vérification.

{}

Le champ block

Chaque réponse de vérification contient un champ block. Consultez ce champ pour décider si l'e-mail/domaine doit être bloqué selon vos listes :

trueL'e-mail ou son domaine est dans la liste noire → block : true. Ajouter un domaine bloque tous les e-mails sur ce domaine.

trueLa liste blanche est activée mais l'e-mail/domaine n'y figure pas → block : true.

falseLa liste blanche est activée et l'e-mail ou son domaine y figure → block : false.

—Aucune liste ne s'applique → block suit le résultat normal de vérification.

Vue d'ensemble

✘

Liste noire

Toujours bloquer certains e-mails ou domaines entiers. Par exemple, ajouter example.com à la liste noire fait que tout e-mail @example.com renverra block : true, quel que soit le résultat de la vérification.

✔

Liste blanche

N'autoriser que certains e-mails ou domaines. Quand la liste blanche est activée, seules les entrées de la liste ont block : false ; tout le reste a block : true. Par exemple, ajouter gmail.com autorise tout @gmail.com, mais [email protected] serait bloqué. Désactivée, la liste blanche n'a aucun effet.

Vous pouvez ajouter un e-mail complet ([email protected]) ou un domaine (example.com). Ajouter un domaine s'applique à tous les e-mails de ce domaine. La casse n'est pas prise en compte.

Fonctionnement

Ordre d'évaluation

D'abord la liste noire — Si l'e-mail ou son domaine est dans la liste noire, le résultat est block : true. Aucune autre logique de liste n'est appliquée.

Liste blanche (si activée) — Si l'e-mail/domaine est dans la liste blanche → block : false. Sinon → block : true.

Liste blanche désactivée — Seules la liste noire et la vérification normale s'appliquent.

La liste noire l'emporte toujours : une adresse en liste noire reste bloquée même si elle figure aussi en liste blanche.

Ce qui est vérifié

Vérification d'e-mail : l'API vérifie l'adresse complète et le domaine contre les deux listes. Toute correspondance applique la règle de la liste.

Vérification de domaine : seul le domaine est vérifié contre la liste noire et (si activée) la liste blanche.

Référence rapide

Liste blanche activée	En liste noire	En liste blanche	valeur de block
Non	Oui	—	`true`
Non	Non	—	Normal
Oui	Oui	Tout	`true`
Oui	Non	Oui	`false`
Oui	Non	Non	`true`

Endpoints API des listes

Tous les endpoints de listes requièrent l'en-tête : X-API-Key: your-api-key

Liste noire

GET/v1/blacklist

Lister les entrées de la liste noire

POST/v1/blacklist

Ajouter un e-mail ou un domaine · { "value": "..." }

DELETE/v1/blacklist

Supprimer une entrée · value=...

Liste blanche

GET/v1/whitelist

Lister les entrées de la liste blanche

POST/v1/whitelist

Ajouter un e-mail ou un domaine · { "value": "..." }

DELETE/v1/whitelist

Supprimer une entrée · value=...

GET/v1/whitelist/enabled

Obtenir l'état de la liste blanche · { "enabled": boolean }

PUT/v1/whitelist/enabled

Activer/désactiver la liste blanche · { "enabled": true | false }

Exemples de codes (cURL)

✘

Liste noire

GET/v1/blacklist

Lister les entrées de la liste noire

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

Ajouter un e-mail ou un domaine

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Supprimer une entrée

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Liste blanche

GET/v1/whitelist

Lister les entrées de la liste blanche

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

Ajouter un e-mail ou un domaine

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Supprimer une entrée

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Obtenir l'état de la liste blanche

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Activer/désactiver la liste blanche

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Format de la valeur

[email protected] — E-mail : format valide, ex. [email protected]
example.com — Domaine : format valide, ex. example.com

Les valeurs invalides sont rejetées avec 400. Les entrées sont stockées normalisées. Les doublons sont fusionnés en une seule entrée.

Où les listes sont appliquées

Les règles des listes sont appliquées après la vérification. Les réponses de vérification d'e-mail (simple et par lot) et de domaine incluent déjà la liste noire et blanche de l'utilisateur dans le champ block.

Serveur MCP (intégration de l'agent AI)

Intégrez la vérification des courriels directement dans les agents d'intelligence artificielle tels que Cursor et Claude Desktop à l'aide du protocole de contexte de modèle (MCP). Votre assistant IA peut vérifier les courriels, contrôler les domaines et valider la syntaxe sans quitter l'éditeur.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

Mise en place

Ajoutez la configuration suivante à votre fichier de configuration .cursor/mcp.json ou Claude Desktop :

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Outils disponibles

Outil	Description	Entrée	Crédits
verify_email	Vérification complète du courrier électronique, y compris les contrôles de syntaxe, MX, SMTP, jetable, de confidentialité et de délivrabilité.	{ email: string }	1
verify_domain	Vérification complète du domaine, y compris les enregistrements MX, la détection des éléments jetables, de la vie privée et de l'ensemble des éléments.	{ domain: string }	1
check_deliverability	Vérification rapide de la délivrabilité uniquement à l'aide de la vérification MX et SMTP sans appel d'API externe	{ email: string }	1
verify_batch	Vérification par lots d'un maximum de 100 courriels ou domaines en une seule demande	{ inputs: string[] }	1 per item
validate_email_syntax	Validation locale rapide de la syntaxe par rapport à la norme RFC 5322, sans appel au réseau	{ email: string }	0 (free)