// post /v1/bulk/verifier
API de vérification des e-mails en masse
Nettoyez et évaluez des listes de diffusion volumineuses avec un pipeline de vérification asynchrone conçu pour les expéditeurs à grande échelle.
Email addressesJusqu'à 20,000 lignes
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · requête
Email Verifier en masse 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.
- type
- verifier
- list | data | file
- Email addresses
- launch
- true lance la tâche immédiatement
- webhook_url
- Reçoit un événement signé à la fin de la tâche
- rows
- Jusqu'à 20,000 par tâche
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 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
POST /bulk/verifier
201 Created
{
"data": {
"id": 1042
}
}Chaque ligne, telle que GET /email-verifier la renvoie
200 OK
{
"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
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
Créez une opération groupée en téléchargeant une liste d’adresses e-mail, puis lancez l’opération. L'API vérifie tous les e-mails de manière asynchrone à l'aide de contrôles multicouches. Utilisez des webhooks ou des sondages pour suivre les progrès.
Vous pouvez vérifier jusqu'à 100 000 adresses e-mail par opération groupée. Pour des listes plus volumineuses, créez plusieurs opérations groupées.
Chaque e-mail est soumis à une validation de syntaxe, à des vérifications d'enregistrement MX, à une vérification SMTP, à une détection jetable, à une détection fourre-tout et à une évaluation de la délivrabilité.
Si une adresse renvoyée comme valide par Tomba est en rebond définitif, le crédit vous est rendu au titre de la garantie de qualité des données (résultat deliverable du vérificateur ou score de recherche d'au moins 60, envoi dans les 30 jours depuis un domaine doté de SPF, DKIM et DMARC).
La vitesse dépend de la taille de la liste et de la rapidité de réponse de chaque serveur de messagerie. Interrogez le statut de la tâche ou configurez un webhook pour être averti de sa fin.
Chaque résultat comprend l'e-mail, le statut de vérification (valide, invalide, accept_all, inconnu), le score de confiance, l'indicateur jetable, le fournisseur SMTP et les enregistrements MX.
Une fois le traitement terminé, utilisez le point de terminaison de téléchargement pour obtenir les résultats au format CSV ou JSON. Les résultats incluent toutes les données de vérification pour chaque e-mail.
Oui, configurez une URL de webhook pour recevoir des notifications lorsque votre vérification groupée est terminée ou lorsque des erreurs se produisent pendant le traitement.
Les domaines accept-all peuvent être valides mais plus risqués. Donnez la priorité à des scores de confiance plus élevés et envisagez des stratégies d’envoi segmentées pour ces enregistrements.
Vérifiez les listes proches de l'heure d'envoi, supprimez les adresses invalides et jetables et revérifiez périodiquement les anciennes listes pour maintenir la délivrabilité.