BillionVerify LogoBillionVerify

検証理由コード

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_deliverableSMTP RCPT が 250 OK を返した——メールボックスの配信可能を確認。Microsoft 365 の DBEB モードが配信を確認した場合にも返されます。
yahoo_api_verifiedYahoo または AOL のアカウント照会で、アカウントの存在を確認した。
microsoft_api_verifiedMicrosoft の個人向けアカウント照会(Outlook.com、Hotmail、Live、MSN)で、アカウントの存在を確認した。
unitedinternet_api_verifiedGMX.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_foundSMTP 550/5xx により、リモートサーバーにそのメールボックスが存在しないことを確認した。
mailbox_disabledメールボックスは存在するが、無効化または停止されている。
host_not_foundMX ホスト名が応答しなかった——ホストに到達できないか、存在しない。
yahoo_api_not_deliverableYahoo または AOL のアカウント照会で、アカウントが存在しないことを確認した。
microsoft_api_not_deliverableMicrosoft の個人向けアカウント照会で、アカウントが存在しないことを確認した。
unitedinternet_api_not_deliverableGMX.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_relayMicrosoft 365 のドメインが内部リレーとして構成されている——すべての RCPT が受け付けられるが、個別には検証されていない。
gateway_accept_allセキュリティゲートウェイ(Mimecast、Proofpoint など)が受信をすべて許可するモードになっている。
forwarding_aliasメール転送エイリアスサービス(SimpleLogin、Firefox Relay、Duck.com)。
yahoo_isp_accept_allYahoo のメール基盤でホストされている 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);
}

On this page