BillionVerify LogoBillionVerify

Коды причин верификации

Полный справочник всех кодов 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_deliverableSMTP 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_foundMX-хост не ответил — хост недоступен или не существует.
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);
}

On this page