// get /v1/email-verifier
API Vérification d'Email
Vérifiez la délivrabilité des emails en temps réel avec des vérifications SMTP, la validation MX et la détection catch-all via notre API RESTful.
1 verification credit
// console api
ExempleExemple de réponse tiré de la référence de l'API
- email.email
- richard@piedpiper.com
- email.result
- deliverable
- email.status
- valid
- email.score
- 99
- email.smtp_provider
- email.accept_all
- false
- email.disposable
- false
- email.webmail
- false
- email.greylisted
- false
// 01 · requête
Email Verifier tient en une requête HTTPS
Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.
GET
/email-verifieremailobligatoire- The address to verify
enrich_mobilefalse- Also return phone numbers
curl -G https://api.tomba.io/v1/email-verifier \
--data-urlencode "email=richard@piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/email-verifier?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-verifier",
params={
"email": "richard@piedpiper.com",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · réponse
Ce qui est renvoyé
Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.
GET
/email-verifierdata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
GET /email-verifier
200 OK· 1 verification credit
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"phone_data": null
}
}// 03 · coût et limites
Ce que coûte un appel
Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.
// coût
1verification credit
Facturé quand: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.
Comment fonctionnent les crédits// limites de débit
Requêtes par seconde / minute / jour| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Faites défiler horizontalement pour voir toutes les colonnes
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Limites de débit
Validation du format, enregistrements MX, vérification de boîte mail SMTP, détection catch-all, détection d'adresses jetables, indicateur d'adresse de rôle, vérification de fournisseur gratuit et gestion du greylisting.
Oui. Chaque plan inclut des crédits de vérification correspondants sans coût supplémentaire.
Oui. L'API Vérification d'Email en Masse traite des milliers d'emails à la fois.
Les limites dépendent du plan, en requêtes par seconde / par minute / par jour : Free 1 / 2 / 10, Basic 2 / 40 / 500, Growth 3 / 60 / 1 000, Pro 5 / 100 / 4 000. Pro Plus et Scale n'ont aucune limite, et Enterprise autorise 100 000 requêtes par jour sans limite par seconde. Chaque réponse inclut des en-têtes de limite de débit ; consultez Limites de débit.
Deliverable signifie que la boîte existe et accepte le courrier. Undeliverable signifie que l'adresse rebondit. Risky couvre les domaines catch-all ou les problèmes temporaires. Unknown signifie que le serveur n'a pas répondu.
Oui. Elle signale les adresses temporaires de fournisseurs comme Mailinator, Guerrilla Mail et plus de 3 000 autres domaines jetables.
Un contrôle de syntaxe ne vérifie que le format. Tomba réalise un échange SMTP complet avec le serveur de messagerie, contrôle les enregistrements MX et détecte les adresses catch-all, jetables et génériques.
Oui. Les temps de réponse varient selon l'endpoint et la difficulté à vérifier une adresse : prévoyez un délai d'expiration généreux (la documentation suggère jusqu'à 180 secondes) et utilisez les traitements en masse ou les webhooks pour les gros volumes.