検証理由コード
BillionVerify API が返すすべての reason コードの完全リファレンス——各コードの意味と対応方法。
使い方を見る
メール検証の仕組みとは?層ごとに解説
構文から SMTP までのメール検証の仕組み:結果を決める 9 つの層を、1 つのアドレスを追いながら見ていきます。アドレスが途中で止まる場所、メールサーバーの応答の読み方、Catch-all のテスト方法、各結果の費用がわかります。
すべての検証結果には reason フィールドが含まれており、そのメールアドレスがそのステータスになった理由を説明します。このリファレンスを使えば、正確なフィルタリングロジックの構築、想定外の結果の原因調査、送信戦略の調整ができます。
reason の仕組み
reason フィールドは、すべての検証レスポンスで status フィールドと並んで返されます。
{
"email": "user@example.com",
"status": "valid",
"reason": "smtp_deliverable"
}reason は安定した文字列識別子です——フィルタリングルールや後続の条件分岐ロジックでそのまま使えます。
メールボックスの種類ごとの検証方法
得られる reason は、受信者のプロバイダーをどのようにチェックできるかによって決まります。
- ビジネスドメイン(Google Workspace、Microsoft 365、自社運用のメールサーバー)では、まさにそのメールボックスに対してリアルタイムの SMTP RCPT チェックを行います。先に同じドメインのランダムなアドレスを試すため、キャッチオールドメイン、Microsoft 365 の内部リレー、受信をすべて許可するモードのセキュリティゲートウェイは、
validではなくcatchallと報告されます。 - Gmail は、リアルタイムの SMTP RCPT チェックを行います。
- Yahoo、AOL、Outlook.com、Hotmail、Live、MSN は SMTP による検証をブロックするため、プロバイダー固有のアカウント照会でチェックします。これらは
yahoo_api_*またはmicrosoft_api_*の reason を返し、アカウントが存在するかを確認します。 - GMX、web.de、Mail.ru、Yandex などの地域プロバイダー は、プロバイダー固有のペース制御で検証します。レート制限、グレーリスト、チェックの拒否により、
unknownの結果が増えます。 - Apple iCloud、Proton、Tuta は信頼できるチェックを一切認めていないため、これらのアドレスは常に
unknownとsmtp_unverifiableを返します。
unknown の結果は、どの reason であっても課金されません。
Valid(有効)
status: "valid" のメールは、配信可能と確認されています。
| reason | 説明 |
|---|---|
smtp_deliverable | SMTP RCPT が 250 OK を返した——メールボックスの配信可能を確認。Microsoft 365 の DBEB モードが配信を確認した場合にも返されます。 |
yahoo_api_verified | Yahoo または AOL のアカウント照会で、アカウントの存在を確認した。 |
microsoft_api_verified | Microsoft の個人向けアカウント照会(Outlook.com、Hotmail、Live、MSN)で、アカウントの存在を確認した。 |
unitedinternet_api_verified | GMX.com / mail.com のアカウント照会で、アカウントの存在を確認した。 |
Invalid(無効)
status: "invalid" のメールはリストから削除してください——配信は不可能です。
| reason | 説明 |
|---|---|
invalid_syntax | メールアドレスが構文解析に失敗した——ローカル部分やドメインの形式が不正、または @ がない。課金されません。 |
no_mx_records | ドメインに MX レコードがない(NXDOMAIN または MX ルックアップ結果が空)。 |
null_mx | ドメインが null MX レコード(RFC 7505)を公開している——メールを一切受け付けないと明示している。 |
spf_reject_all | ドメインに MX レコードがなく、-all を含む SPF レコードがある——ドメインはすべての受信メールを明示的に拒否している。 |
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" のメールは、確定的に検証できませんでした。不明の結果は課金されません。一部は一時的なもの(再試行可能)で、その他は構造上の制限によるものです。
| reason | 再試行可能 | 説明 |
|---|---|---|
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 | はい | Proofpoint の AD 非同期ルックアップが進行中(受信者検証中の 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 | いいえ | プロバイダーのキャパシティが再試行期間(約 2 時間)の間ずっと満杯だったため、これらのアドレスは結論が出ないままジョブが終了した。 |
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" のメールは、すべてのアドレス宛てのメールを受け付けるドメインに属しています。個別のアドレスの配信可否は確認できません。
| reason | 説明 |
|---|---|
catch_all_domain | ドメインがキャッチオールと確認された——ランダムな RCPT プローブをメールサーバーが受け付けた。 |
catch_all_deliverable | キャッチオールドメインで、対象のアドレスの RCPT も 250 OK を返した。 |
catch_all_inferred | キャッシュされた証拠からキャッチオールと推定した(間接的な判定で、リアルタイムのプローブではない)。 |
m365_internal_relay | Microsoft 365 のドメインが内部リレーとして構成されている——すべての RCPT が受け付けられるが、個別には検証されていない。 |
gateway_accept_all | セキュリティゲートウェイ(Mimecast、Proofpoint など)が受信をすべて許可するモードになっている。 |
forwarding_alias | メール転送エイリアスサービス(SimpleLogin、Firefox Relay、Duck.com)。 |
yahoo_isp_accept_all | Yahoo のメール基盤でホストされている ISP ドメイン(例:att.net、sbcglobal.net、verizon.net)——プロバイダーがすべての宛先を受け付けるため、メールボックス単位のチェックはできない。 |
region_consumer_accept_all | すべての受信メールを受け付けることが知られている地域の個人向けドメイン(過去の結果)。 |
bucket_default_skip_smtp_catchall | アカウント単位の検証モードが SMTP によるキャッチオール検出をスキップする設定になっている。 |
Role(役割)
status: "role" のメールは、共有受信箱(例:info@、support@、noreply@)に属しています。これらのアドレスは通常は配信可能ですが、エンゲージメントは低くなります。
役割アドレスは 元になった SMTP チェックの reason を引き継ぎます——このステータス専用の reason コードはありません。たとえば、SMTP チェックを通過した役割アドレスは reason: "smtp_deliverable" と表示されます。
Disposable(使い捨て)
status: "disposable" のメールは、一時的なメールサービスに属しています。これらを受け入れると、質の低いサインアップにつながることがよくあります。
| reason | 説明 |
|---|---|
disposable_domain | ドメインが既知の使い捨て / 一時メールプロバイダーとして登録されている。 |
Risky(過去の結果のみ)
新しい検証では status: "risky" は返されなくなりました。唯一の発生源だった Spamhaus Domain Blocklist のチェックは、2026-09-11 に廃止されたためです。この日付より前に作成された結果には、今も risky が表示されることがあります。
それらの過去の結果で risky は、アドレス自体はほぼ配信可能であるものの、受信ドメインがスパム、フィッシング、マルウェア、ボットネット C&C の活動で Spamhaus に登録されていたことを意味していました。risk_reasons 配列がその理由を示します。
risk_reasons の値 | 説明 |
|---|---|
spamhaus_dbl_spam | ドメインがスパムの発信元として登録されている。 |
spamhaus_dbl_phish | ドメインがフィッシングドメインとして登録されている。 |
spamhaus_dbl_malware | ドメインがマルウェア配布ドメインとして登録されている。 |
spamhaus_dbl_botnet_cc | ドメインがボットネットのコマンド&コントロール基盤として登録されている。 |
フィルタリングでの reason の使い方
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);
}