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

APIステータス

はじめに

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

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

シングル検証

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

エンドポイント

GET /v1/verify

パラメータ

名称	タイプ	必須	説明
input	string	はい	確認する電子メールアドレスまたはドメイン（例：[email protected] または 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": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

コード例

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

試してみる

APIキー

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

メールアドレスまたはドメイン

一緒に試してみよう：

バッチ検証

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

エンドポイント

POST /v1/verify/batch

パラメータ

名称	タイプ	必須	説明
inputs	array 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": [
      "[email protected]",
      "[email protected]"
    ]
  }'

試してみる

APIキー

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

メールアドレスまたはドメイン

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

納品物のみのチェック

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

エンドポイント

GET /v1/verify/deliverable

パラメータ

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

応答フィールド

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

回答例

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "[email protected]",
  "remaining_credits": 99
}

コード例

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -H "X-API-Key: your-api-key"

試してみる

APIキー

エンドポイントをテストするには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 は許可され、[email protected] はブロックされます。無効時はホワイトリストは適用されません。

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

仕組み

評価順

まずブラックリスト — メールアドレスまたはそのドメインがブラックリストにあれば結果は block: true。それ以降のリスト処理は行いません。

ホワイトリスト（有効時） — メール/ドメインがホワイトリストにあれば → block: false。なければ → block: true。

ホワイトリスト無効 — ブラックリストと通常の検証のみが適用されます。

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

照合対象

メール検証 — 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 }

コード例 (cURL)

✘

ブラックリスト

GET/v1/blacklist

ブラックリスト一覧

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

メールまたはドメインを追加

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

エントリを削除

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

ホワイトリスト

GET/v1/whitelist

ホワイトリスト一覧

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

メールまたはドメインを追加

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

エントリを削除

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

ホワイトリストの状態を取得

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

ホワイトリストの有効/無効を設定

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

値の形式

[email protected] — メール：有効な形式、例 [email protected]
example.com — ドメイン：有効な形式、例 example.com

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

リストの適用箇所

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

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

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

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

セットアップ

以下の設定を.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_domain	MXレコード、使い捨て、プライバシー、キャッチオール検出を含む完全なドメイン検証	{ domain: string }	1
check_deliverability	外部APIを呼び出すことなく、MXおよびSMTP検証を使用した配信可能性のみの高速チェック	{ email: string }	1
verify_batch	1回のリクエストで最大100メールまたはドメインの一括検証	{ inputs: string[] }	1 per item
validate_email_syntax	RFC 5322に対するローカル構文検証をネットワーク・コールなしで素早く行う。	{ email: string }	0 (free)