Коды причин верификации
Полный справочник всех кодов reason, которые возвращает API BillionVerify: что означает каждая причина и как на неё реагировать.
Посмотрите, как это работает
Как работает проверка email? Слой за слоем
Как работает проверка email, от синтаксиса до SMTP: пройдите вместе с адресом девять слоёв, которые определяют его результат. Узнайте, где адреса отсеиваются раньше, как читается ответ почтового сервера, как проверяется catch-all и сколько стоит каждый результат.
Каждый результат верификации содержит поле reason, которое объясняет, почему адрес получил свой статус. Используйте этот справочник, чтобы строить точные правила фильтрации, разбирать неожиданные результаты и настраивать стратегию рассылки.
Как работают причины
Поле reason присутствует во всех ответах верификации рядом с полем status:
{
"email": "user@example.com",
"status": "valid",
"reason": "smtp_deliverable"
}Причины — это стабильные строковые идентификаторы: их можно использовать напрямую в правилах фильтрации и в условной логике ниже по конвейеру.
Как проверяется каждый тип ящика
Какую причину вы получите, зависит от того, как можно проверить провайдера получателя:
- Корпоративные домены (Google Workspace, Microsoft 365, собственные почтовые серверы) проходят живую SMTP-проверку RCPT для конкретного ящика. Сначала проверяется случайный адрес на том же домене, поэтому домены catch-all, внутренняя ретрансляция Microsoft 365 и защитные шлюзы в режиме accept-all получают статус
catchall, а неvalid. - Gmail проходит живую SMTP-проверку RCPT.
- Yahoo, AOL, Outlook.com, Hotmail, Live и MSN блокируют SMTP-верификацию, поэтому они проверяются через запросы аккаунтов, специфичные для провайдера. Такие проверки возвращают причины
yahoo_api_*илиmicrosoft_api_*и подтверждают, существует ли аккаунт. - GMX, web.de, Mail.ru, Yandex и другие региональные провайдеры проверяются с учётом собственных ограничений темпа у каждого провайдера. Лимиты частоты, грейлистинг и отказы в проверке приводят к большему числу результатов
unknown. - Apple iCloud, Proton и Tuta не допускают надёжной проверки, поэтому их адреса всегда возвращают
unknownс причинойsmtp_unverifiable.
Результаты unknown никогда не тарифицируются, какой бы ни была причина.
Valid (Валидный)
Письма со status: "valid" подтверждены как доставляемые.
| Причина | Описание |
|---|---|
smtp_deliverable | SMTP RCPT вернул 250 OK — почтовый ящик подтверждён как доставляемый. Также возвращается, когда режим DBEB в Microsoft 365 подтверждает доставку. |
yahoo_api_verified | Запрос аккаунта Yahoo или AOL подтвердил, что аккаунт существует. |
microsoft_api_verified | Запрос потребительского аккаунта Microsoft (Outlook.com, Hotmail, Live, MSN) подтвердил, что аккаунт существует. |
unitedinternet_api_verified | Запрос аккаунта GMX.com / mail.com подтвердил, что аккаунт существует. |
Invalid (Невалидный)
Письма со status: "invalid" следует удалить из списка — доставка невозможна.
| Причина | Описание |
|---|---|
invalid_syntax | Адрес не прошёл синтаксический разбор — некорректная локальная часть, домен или отсутствует @. Никогда не тарифицируется. |
no_mx_records | У домена нет MX-записей (NXDOMAIN или пустой результат запроса MX). |
null_mx | Домен публикует null MX-запись (RFC 7505) — он явно не принимает почту. |
spf_reject_all | У домена нет MX-записей и есть SPF-запись с -all — домен явно отклоняет всю входящую почту. |
mailbox_not_found | Ответ SMTP 550/5xx подтвердил, что почтового ящика на удалённом сервере не существует. |
mailbox_disabled | Почтовый ящик существует, но отключён или деактивирован. |
host_not_found | MX-хост не ответил — хост недоступен или не существует. |
yahoo_api_not_deliverable | Запрос аккаунта Yahoo или AOL подтвердил, что аккаунта не существует. |
microsoft_api_not_deliverable | Запрос потребительского аккаунта Microsoft подтвердил, что аккаунта не существует. |
unitedinternet_api_not_deliverable | Запрос аккаунта GMX.com / mail.com подтвердил, что аккаунта не существует. |
Unknown (Неизвестный)
Письма со status: "unknown" не удалось проверить окончательно. Результаты unknown никогда не тарифицируются. Часть причин временная (можно повторить попытку), остальные отражают структурные ограничения.
| Причина | Повторная попытка | Описание |
|---|---|---|
smtp_unverifiable | Нет | Провайдер не допускает надёжной SMTP-верификации (Apple iCloud, Proton, Tuta). |
smtp_blocked | Нет | Удалённый SMTP-сервер явно заблокировал соединение или внёс его в чёрный список. |
smtp_eof_blocked | Да | MX закрыл соединение до отправки баннера — как правило, ограничитель частоты по IP или правило fail2ban. |
smtp_timeout | Да | Операция SMTP завершилась по таймауту (дедлайн контекста или отмена). |
smtp_connection_failed | Да | Общая ошибка SMTP-соединения — более точного класса не нашлось. |
smtp_rate_limited | Да | Удалённый SMTP-сервер вернул ответ об ограничении частоты (421, 450, 451 или превышен лимит сообщений). |
smtp_greylisted | Да | Обнаружен общий ответ грейлистинга — повторите попытку после паузы. |
smtp_550_unclassified | Да | Сервер вернул 550, который однозначно не означает «пользователь не найден», поэтому адрес не считается невалидным. |
smtp_egress_unavailable | Да | На момент проверки для этого провайдера не было доступного канала выхода для верификации. |
smtp_egress_unselectable | Нет | Ни одному каналу выхода для верификации не разрешено обращаться к этому провайдеру. |
mimecast_greylist | Да | Грейлистинг Mimecast / временный сбой 451. |
proofpoint_ad_lookup | Да | Идёт асинхронный поиск AD в Proofpoint (временный сбой 421 4.1.1 при проверке получателя). |
proofpoint_egress_listed | Нет | Домен под защитой Proofpoint, на который наши проверки сейчас не получают ответа. |
policy_temp_fail | Да | Общий временный сбой 4xx из-за применения политики на удалённой стороне. |
google_rate_limit | Да | Google MX вернул ответ об ограничении частоты или временного отказа. |
google_dmarc_misalignment | Нет | Конфигурация DMARC домена не согласована — Google отклоняет письма согласно политике DMARC. |
m365_ip_rep_block | Да | Microsoft 365 отклонил соединение из-за репутации IP (коды 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | Нет | T-Online принимает проверки только от отправителей из списка разрешённых, поэтому ящик проверить нельзя. |
mailbox_full | Нет | Почтовый ящик существует, но превышена квота (SMTP 452 или ответ о переполненном ящике). |
dns_timeout | Да | Запрос DNS или MX завершился по таймауту — временная проблема резолвера. |
dns_lookup_error | Да | Запрос DNS завершился ошибкой, отличной от NXDOMAIN (SERVFAIL, таймаут UDP или ошибка резолвера). |
dns_resolution_failed | Да | Разрешение DNS не удалось по временной причине. |
yahoo_api_error | Да | Запрос аккаунта Yahoo / AOL завершился ошибкой — общая ошибка. |
yahoo_api_unavailable | Да | Запрос аккаунта Yahoo / AOL был недоступен (сбой работоспособности на уровне пакета). |
yahoo_api_eof | Да | Запрос аккаунта Yahoo / AOL вернул ранний EOF — временный разрыв TCP/TLS. |
yahoo_api_rate_limited | Да | Запрос аккаунта Yahoo / AOL был ограничен по частоте. |
microsoft_api_error | Да | Запрос потребительского аккаунта Microsoft завершился ошибкой или был ограничен. |
microsoft_api_unavailable | Да | Запрос потребительского аккаунта Microsoft был недоступен. |
unitedinternet_api_error | Да | Запрос аккаунта GMX.com / mail.com завершился ошибкой. |
unitedinternet_api_unavailable | Нет | Запрос аккаунта GMX.com / mail.com был недоступен в этом запуске. |
capacity_deferred | Да | Мощность верификации у провайдера была исчерпана, поэтому проверка отложена. |
provider_capacity_exhausted | Нет | Мощность провайдера оставалась исчерпанной на протяжении всего окна повторов (около двух часов), поэтому задача завершилась без вывода по этим адресам. |
carrier_blocked | Нет | Домен японского оператора (docomo.ne.jp, au.com и т. д.) — SMTP заблокирован политикой оператора. |
internal_verifier_error | Да | Неклассифицированная внутренняя ошибка верификатора — временный сбой. |
rate_limited | Да | Адрес был ограничен по частоте при пакетной обработке (псевдоним smtp_rate_limited в файловых задачах). |
bucket_default_skip_smtp_unknown | Нет | Режим верификации на уровне аккаунта настроен на пропуск SMTP — результат основан только на проверках домена. |
mx_only_verification_semaphore_timeout | Да | Истёк таймаут семафора параллельности SMTP — резервная проверка только по MX подтвердила наличие валидных MX-записей, но отдельно проверить ящик не удалось. |
Catch-all (Ловит всё)
Письма со status: "catchall" принадлежат доменам, которые принимают почту для любых адресов. Доставляемость конкретного адреса подтвердить нельзя.
| Причина | Описание |
|---|---|
catch_all_domain | Домен подтверждён как catch-all — почтовый сервер принял случайный зонд RCPT. |
catch_all_deliverable | Домен catch-all, и конкретный адрес тоже вернул 250 OK на RCPT. |
catch_all_inferred | Статус catch-all выведен из кэшированных данных (косвенно, а не живой зонд). |
m365_internal_relay | Домен Microsoft 365 настроен как внутренняя ретрансляция — все RCPT принимаются, но отдельно не проверяются. |
gateway_accept_all | Защитный шлюз (Mimecast, Proofpoint и др.) работает в режиме accept-all. |
forwarding_alias | Сервис псевдонимов для пересылки почты (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | Домен интернет-провайдера на почтовой инфраструктуре Yahoo (например, att.net, sbcglobal.net, verizon.net) — провайдер принимает всех получателей, поэтому проверить конкретный ящик невозможно. |
region_consumer_accept_all | Региональный потребительский домен, известный тем, что принимает всю входящую почту (старые результаты). |
bucket_default_skip_smtp_catchall | Режим верификации на уровне аккаунта настроен на пропуск определения catch-all по SMTP. |
Role (Ролевой аккаунт)
Письма со status: "role" принадлежат общим ящикам (например, info@, support@, noreply@). Эти адреса, как правило, доставляемы, но вовлечённость у них низкая.
Ролевые адреса наследуют reason от базовой SMTP-проверки — отдельных кодов причин для этого статуса нет. Например, ролевой адрес, прошедший SMTP, покажет reason: "smtp_deliverable".
Disposable (Одноразовый)
Письма со status: "disposable" принадлежат сервисам временной электронной почты. Принимать такие адреса обычно означает получать регистрации низкого качества.
| Причина | Описание |
|---|---|
disposable_domain | Домен числится в списке известных провайдеров одноразовой / временной почты. |
Risky (Рискованный; только старые результаты)
Новые проверки больше не возвращают status: "risky". Единственный источник этого статуса — проверка по Spamhaus Domain Blocklist — удалён 2026-09-11. Статус risky по-прежнему можно встретить в результатах, созданных до этой даты.
В этих старых результатах risky означал, что адрес, скорее всего, доставляем, но домен получателя внесён в список Spamhaus за спам, фишинг, вредоносное ПО или активность управляющей инфраструктуры ботнетов (C&C). Причину объясняет массив risk_reasons:
Значение risk_reasons | Описание |
|---|---|
spamhaus_dbl_spam | Домен внесён в список как источник спама. |
spamhaus_dbl_phish | Домен внесён в список как фишинговый. |
spamhaus_dbl_malware | Домен внесён в список как домен распространения вредоносного ПО. |
spamhaus_dbl_botnet_cc | Домен внесён в список как управляющая инфраструктура ботнета. |
Использование причин при фильтрации
Вы можете сочетать status и reason для точной сегментации списка. Например, чтобы оставить письма со статусом unknown, которые являются неизвестными только из-за временных проблем:
function isRetryableUnknown(result) {
const retryableReasons = new Set([
'capacity_deferred', 'context_cancelled', 'dns_lookup_error',
'dns_resolution_failed', 'dns_timeout', 'google_rate_limit',
'internal_verifier_error', 'm365_ip_rep_block', 'microsoft_api_error',
'microsoft_api_unavailable', 'mimecast_greylist',
'mx_only_verification_semaphore_timeout', 'policy_temp_fail',
'proofpoint_ad_lookup', 'rate_limited', 'smtp_550_unclassified',
'smtp_connection_failed', 'smtp_egress_unavailable', 'smtp_eof_blocked',
'smtp_greylisted', 'smtp_rate_check_failed', 'smtp_rate_limited',
'smtp_rate_wait_failed', 'smtp_timeout', 'unitedinternet_api_error',
'yahoo_api_eof', 'yahoo_api_error', 'yahoo_api_rate_limited',
'yahoo_api_unavailable',
]);
return result.status === 'unknown' && retryableReasons.has(result.reason);
}