Vérifier une adresse e-mail
Si une adresse vaut un envoi, avant le premier message.
Exécute l'un des 2 appels sur votre espace de travail.
GET /tools/address
Si une adresse vaut un envoi, avant le premier message.
Exemple
Ne nécessite aucun scope. result vaut valid, risky, invalid ou unknown, et reasons dit pourquoi : mauvaise syntaxe, domaine qui n’accepte pas le courrier, boîte jetable ou partagée, ou faute de frappe probable, avec la correction dans suggestion. Avec emails:read, workspace ajoute ce que cet espace de travail sait de l’adresse.
curl "$OE/tools/[email protected]" -H "$AUTH"{ "object": "address_check", "email": "[email protected]", "normalized": "[email protected]", "result": "risky", "reasons": ["typo_suspected"], "suggestion": "[email protected]", "checks": { "syntax": true, "mx": { "status": "found", "hosts": ["mx.gmial.com"] }, "nullMx": false, "disposable": false, "role": false, "freeProvider": false, "mailbox": null }, "workspace": { "suppressed": false, "lastBouncedAt": null, "lastDeliveredAt": null }, "checkedAt": "2026-10-11T09:41:00.000Z"}Une adresse dont la syntaxe est fausse n’est pas une erreur. La réponse est 200 avec result à invalid.
deep=true demande aussi si la boîte existe, dans checks.mailbox. Il nécessite emails:send et est facturé par adresse via le paiement à l’usage. Si le paiement à l’usage est désactivé, c’est un 409 deep_check_unavailable, et rien n’est facturé.
Vérifier une liste
POST /tools/addresses accepte jusqu’à 100 adresses dans emails et répond avec une vérification pour chacune, dans l’ordre d’envoi. deep s’applique à toutes.
curl -X POST "$OE/tools/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "list", "data": [ { "object": "address_check", "email": "[email protected]", "result": "valid", "reasons": [] }, { "object": "address_check", "email": "[email protected]", "result": "risky", "reasons": ["role_address"] } ]}Plus de 100 adresses, ou aucune, donne un 422 invalid_parameter sur emails.