Docs de l'API de validation des courriels

Statut de l'API

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

NomTypeExigéeDescription
inputstringOuiAdresse électronique ou domaine à vérifier (par exemple, [email protected] ou example.com)

apiDocs.responseFields

Champ d'applicationDescription
validIndique si le format du courrier électronique est correct
blockIndique si l'e-mail doit être bloqué (vrai si jetable, privacy, applePrivateEmail, deliverable ou catch_all est vrai).
disposableDétermine si l'adresse électronique est temporaire ou jetable.
privacyDétermine si le serveur de messagerie utilise un alias ou une redirection de courrier électronique.
applePrivateEmailIndique si l'adresse électronique est une adresse privée Apple.
deliverableVérifie que la boîte aux lettres existe et qu'elle peut recevoir des courriels.
domainLa partie domaine de l'adresse électronique
email_addressL'adresse électronique
catch_allIndique 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_foundIndique si le domaine possède des serveurs de messagerie valides (enregistrements MX)
remaining_creditsLe nombre de crédits API restant sur votre compte

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

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

Essayez avec :

Vérification des lots

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

Point final

POST /v1/verify/batch

Paramètres

NomTypeExigéeDescription
inputsarray of stringsOuiTableau 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

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

Essayez avec différents domaines :