// get /v1/email-verifier
Email Verifier API
Verifieer de afleverbaarheid van e-mails in realtime met SMTP-controles, MX-validatie en catch-all-detectie via onze RESTful API.
1 verification credit
// api-console
VoorbeeldVoorbeeldantwoord uit de API-naslag
- 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 · verzoek
Email Verifier is één HTTPS-verzoek
Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.
GET
/email-verifieremailverplicht- 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 · antwoord
Wat je terugkrijgt
JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.
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 · kosten en limieten
Wat een aanroep kost
Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.
// kosten
1verification credit
In rekening gebracht als: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
Fouten, 429- en 451-antwoorden en hetzelfde verzoek opnieuw binnen je gebruiksvenster kosten niets.
Hoe credits werken// rate limits
Verzoeken per seconde / minuut / dag| 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 |
Scroll opzij voor alle kolommen
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. Rate limits
Formaatvalidatie, MX-records, SMTP-mailboxcontrole, catch-all-detectie, wegwerpdetectie, rolgebaseerde vlag, gratis provider controle en greylisting-afhandeling.
Ja. Elk abonnement bevat bijpassende verificatiecredits zonder extra kosten.
Ja. De Bulk Email Verifier API verwerkt duizenden e-mails tegelijk.
Limieten gelden per abonnement, in verzoeken per seconde / minuut / dag: Free 1 / 2 / 10, Basic 2 / 40 / 500, Growth 3 / 60 / 1.000, Pro 5 / 100 / 4.000. Pro Plus en Scale hebben geen limiet, en Enterprise staat 100.000 verzoeken per dag toe zonder limiet per seconde. Elk antwoord bevat rate-limit-headers; zie Rate limits.
Deliverable betekent dat de mailbox bestaat en mail accepteert. Undeliverable betekent dat het adres bouncet. Risky staat voor catch-all-domeinen of tijdelijke problemen. Unknown betekent dat de server niet antwoordde.
Ja. Het markeert tijdelijke adressen van aanbieders als Mailinator, Guerrilla Mail en meer dan 3.000 andere wegwerpdomeinen.
Een syntaxiscontrole kijkt alleen naar het formaat. Tomba voert een volledige SMTP-handshake met de mailserver uit, controleert MX-records en herkent catch-all-, wegwerp- en functieadressen.
Ja. Responstijden verschillen per endpoint en per hoe moeilijk een adres te verifiëren is, dus stel een ruime timeout in (de documentatie adviseert tot 180 seconden) en gebruik bulkjobs of webhooks voor grote volumes.