メール検証APIドキュメント

APIステータス

はじめに

すべてのAPIリクエストには、APIキーを使用した認証が必要です。APIキーはダッシュボードで確認できます。

ヘッダー"x-api-key：あなたのapi-key"

シングル検証

1つのEメールアドレスまたはドメインの有効性、使い捨てステータス、プライバシーサービス、配信可能性を検証します。

エンドポイント

GET /v1/verify

パラメータ

名称タイプ必須説明
inputstringはい確認する電子メールアドレスまたはドメイン（例：test@example.com または example.com）

応答フィールド

フィールド説明
valid電子メールのフォーマットが正しいかどうかを示す
blockメールがブロックされるべきかどうかを示します (disposable、privacy、applePrivateEmail、deliverable または catch_all が true の場合は true)。
disposable電子メールアドレスが一時的なものか使い捨てのものかを判断します。
privacyメールサーバーが電子メールのエイリアスまたはフォワーダーを利用しているかどうかを判断する。
applePrivateEmailメールがAppleのプライベートメールアドレスであるかどうかを示します。
deliverableメールボックスが存在し、メールを受信できるかどうかをチェックします。
domainメールアドレスのドメイン部分
email_addressメールアドレス
catch_allドメインが、受信者アドレスに関係なくすべての受信メールを受け入れるキャッチオールメール設定を持っているかどうかを示します。
mx_foundドメインに有効なメールサーバ(MXレコード)があるかどうかを示します。
remaining_creditsアカウントに残っているAPIクレジットの数

ブラックリスト/ホワイトリスト：ブロックフィールドにのみリストメンバーシップが反映される。Blacklist → block: true; whitelist → block: false; not in whitelist (when enabled) → block: true。リストに基づいてブロックするかどうかを決定するためにvalidを使用しないでください。

回答例

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

コード例

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -H "X-API-Key: your-api-key"

試してみる

エンドポイントをテストするにはAPIキーが必要です。

一緒に試してみよう：

バッチ検証

1回のリクエストで複数のメールアドレスまたはドメインを検証します（最大100件）。

エンドポイント

POST /v1/verify/batch

パラメータ

名称タイプ必須説明
inputsarray of stringsはい検証する電子メールアドレスまたはドメインの配列

コード例

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

試してみる

エンドポイントをテストするにはAPIキーが必要です。

異なるドメインで試してみてください：

納品物のみのチェック

外部APIを呼び出すことなく、MXおよびSMTP検証を使用して電子メールの配信可能性を高速にチェックします。レスポンスタイムを短縮するために、配信可能性に関連するフィールドのみを返します。

エンドポイント

GET /v1/verify/deliverable

パラメータ

名称タイプ必須説明
inputstringはい配信可能性をチェックするためのメールアドレス（例：test@example.com）。このエンドポイントでは、ドメインのみの入力はサポートされていません。

応答フィールド

フィールド説明
valid電子メールのフォーマットが正しいかどうかを示す
deliverableメールボックスが存在し、メールを受信できるかどうかをチェックします。
mx_foundドメインに有効なメールサーバ(MXレコード)があるかどうかを示します。
catch_allドメインが、受信者アドレスに関係なくすべての受信メールを受け入れるキャッチオールメール設定を持っているかどうかを示します。
email_addressメールアドレス
remaining_creditsアカウントに残っているAPIクレジットの数

回答例

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "test@example.com",
  "remaining_credits": 99
}

コード例

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -H "X-API-Key: your-api-key"

試してみる

エンドポイントをテストするにはAPIキーが必要です。

一緒に試してみよう：

ホワイトリストとブラックリスト

ユーザーごとのブラックリスト・ホワイトリストで、ブロックするメールやドメインを制御できます。これらのリストが検証レスポンスの block フィールドを直接設定します。

{}

block フィールド

各検証レスポンスには block フィールドがあります。リストに基づいてメール/ドメインをブロックするかはこのフィールドで判断してください：

trueメールまたはそのドメインがブラックリストにある → block: true。ドメインを追加すると、そのドメインの全メールがブロックされます。
trueホワイトリストは有効だがメール/ドメインが含まれていない → block: true。
falseホワイトリストが有効でメールまたはそのドメインが含まれている → block: false。
—どちらのリストにも該当しない → block は通常の検証結果に従います。

概要

✘

ブラックリスト

特定のメールまたはドメイン全体を常にブロックします。例：example.com をブラックリストに追加すると、@example.com のメールは検証結果に関係なく block: true を返します。

✔

ホワイトリスト

特定のメールまたはドメインのみ許可します。ホワイトリスト有効時、リストにあるものだけ block: false、それ以外は block: true。例：gmail.com を追加すると @gmail.com は許可され、user@yahoo.com はブロックされます。無効時はホワイトリストは適用されません。

メールアドレス全体（user@example.com）またはドメイン（example.com）を追加できます。ドメインを追加するとそのドメインの全メールに適用されます。大文字小文字は区別されません。

仕組み

評価順

1
まずブラックリスト — メールアドレスまたはそのドメインがブラックリストにあれば結果は block: true。それ以降のリスト処理は行いません。
2
ホワイトリスト（有効時） — メール/ドメインがホワイトリストにあれば → block: false。なければ → block: true。
3
ホワイトリスト無効 — ブラックリストと通常の検証のみが適用されます。

ブラックリストが常に優先されます。ブラックリストにあるアドレスはホワイトリストにもあってもブロックされたままです。

照合対象

メール検証 — API はメールアドレス全体とドメインの両方を両リストと照合します。いずれかに一致するとリストのルールが適用されます。
ドメイン検証 — ブラックリストおよび（有効時）ホワイトリストと照合されるのはドメインのみです。

早見表

ホワイトリスト有効ブラックリストに含むホワイトリストに含むblock の値
いいえはい—true
いいえいいえ—通常
はいはいどちらでもtrue
はいいいえはいfalse
はいいいえいいえtrue

リスト API エンドポイント

すべてのリストエンドポイントでヘッダーが必要です: X-API-Key: your-api-key

ブラックリスト

GET/v1/blacklist
ブラックリスト一覧
POST/v1/blacklist
メールまたはドメインを追加 · { "value": "..." }
DELETE/v1/blacklist
エントリを削除 · value=...

ホワイトリスト

GET/v1/whitelist
ホワイトリスト一覧
POST/v1/whitelist
メールまたはドメインを追加 · { "value": "..." }
DELETE/v1/whitelist
エントリを削除 · value=...
GET/v1/whitelist/enabled
ホワイトリストの状態を取得 · { "enabled": boolean }
PUT/v1/whitelist/enabled
ホワイトリストの有効/無効を設定 · { "enabled": true | false }

値の形式

  • user@example.com — メール：有効な形式、例 user@example.com
  • example.com — ドメイン：有効な形式、例 example.com

無効な値は 400 で拒否されます。エントリは正規化して保存され、重複は1件にまとめられます。

リストの適用箇所

リストのルールは検証後に適用されます。単一・バッチのメール検証およびドメイン検証のレスポンスには、block フィールドにユーザーのブラックリスト・ホワイトリストがすでに反映されています。

MCPサーバー（AIエージェント統合）

モデルコンテキストプロトコル（MCP）を使用して、CursorやClaude DesktopのようなAIエージェントに電子メール検証を直接統合します。AIアシスタントは、エディタを離れることなく、メールの検証、ドメインの確認、構文の検証を行うことができます。

セットアップ

以下の設定を.cursor/mcp.jsonまたはClaude Desktop設定ファイルに追加します：

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

利用可能なツール

工具説明インプットクレジット
verify_email構文、MX、SMTP、使い捨て、プライバシー、配信可能性チェックを含む完全なEメール検証{ email: string }1
verify_domainMXレコード、使い捨て、プライバシー、キャッチオール検出を含む完全なドメイン検証{ domain: string }1
check_deliverability外部APIを呼び出すことなく、MXおよびSMTP検証を使用した配信可能性のみの高速チェック{ email: string }1
verify_batch1回のリクエストで最大100メールまたはドメインの一括検証{ inputs: string[] }1 per item
validate_email_syntaxRFC 5322に対するローカル構文検証をネットワーク・コールなしで素早く行う。{ email: string }0 (free)