// get /v1/email-verifier
Email Verifier API
Проверяйте доставляемость email в реальном времени с помощью SMTP-проверок, валидации MX и обнаружения catch-all через наш RESTful API.
1 verification credit
// консоль api
ПримерПример ответа из справочника 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 · запрос
«Email Verifier» — это один HTTPS-запрос
Отправьте параметры с вашим ключом и секретом. Все SDK, CLI и MCP-сервер выполняют этот же вызов.
GET
/email-verifieremailобязательный- 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 · ответ
Что возвращается
JSON, одинаковый на любом языке. Поля, которые Tomba не знает, равны null — без догадок.
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 · стоимость и лимиты
Сколько стоит вызов
Вызов оплачивается только при условии, указанном ниже. Лимиты запросов зависят от вашего тарифа.
// стоимость
1verification credit
Когда списывается: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
Ошибки, ответы 429 и 451, а также повтор того же запроса в пределах окна использования ничего не стоят.
Как работают кредиты// лимиты запросов
Запросов в секунду / минуту / день| 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 |
Прокрутите вбок, чтобы увидеть все столбцы
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. Лимиты запросов
Валидация формата, MX-записи, проверка SMTP почтового ящика, обнаружение catch-all, обнаружение одноразовых адресов, флаг ролевого адреса, проверка бесплатного провайдера и обработка greylisting.
Да. Каждый тариф включает соответствующие кредиты на верификацию без дополнительной платы.
Да. API массовой верификации email обрабатывает тысячи адресов одновременно.
Лимиты зависят от тарифа, в запросах в секунду / в минуту / в день: Free 1 / 2 / 10, Basic 2 / 40 / 500, Growth 3 / 60 / 1 000, Pro 5 / 100 / 4 000. На Pro Plus и Scale лимитов нет, а Enterprise допускает 100 000 запросов в день без ограничения в секунду. Каждый ответ содержит заголовки с лимитами запросов; подробнее в разделе Лимиты запросов.
Deliverable: ящик существует и принимает почту. Undeliverable: письма на адрес возвращаются. Risky: домены catch-all или временные проблемы. Unknown: сервер не ответил.
Да. Отмечает временные адреса таких сервисов, как Mailinator, Guerrilla Mail, и ещё более 3 000 одноразовых доменов.
Проверка синтаксиса подтверждает лишь формат. Tomba выполняет полное SMTP-рукопожатие с почтовым сервером, проверяет MX-записи и распознаёт catch-all, одноразовые и ролевые адреса.
Да. Время ответа зависит от эндпоинта и от того, насколько сложно проверить адрес, поэтому задайте щедрый тайм-аут (документация советует до 180 секунд), а для больших объёмов используйте массовые задачи или вебхуки.