Документы API проверки подлинности электронной почты

Начало работы

Все запросы к API требуют аутентификации с помощью ключа API. Вы можете найти свой ключ API на приборной панели.

Заголовок: "x-api-key: your-api-key"

Одиночная верификация

Проверьте один адрес электронной почты или домен на достоверность, одноразовость, наличие служб конфиденциальности и возможность доставки.

Конечная точка

GET /v1/verify

Параметры

Имя	Тип	Требуется	Описание
input	string	Да	Адрес электронной почты или домен для проверки (например, [email protected] или example.com).

Поля ответа

Поле	Описание
valid	Указывает, правильно ли указан формат электронной почты
block	Указывает, следует ли блокировать электронную почту (истинно, если истинны значения disposable, privacy, applePrivateEmail, deliverable или catch_all).
disposable	Определяет, является ли адрес электронной почты временным или одноразовым.
privacy	Определяет, используется ли на почтовом сервере почтовый псевдоним или переадресация.
applePrivateEmail	Указывает, является ли этот адрес электронной почты адресом Apple Private.
deliverable	Проверяет, существует ли почтовый ящик и может ли он принимать сообщения.
domain	Доменная часть адреса электронной почты
email_address	Адрес электронной почты
catch_all	Указывает, есть ли в домене конфигурация универсальной электронной почты, которая принимает все входящие письма независимо от адреса получателя.
mx_found	Указывает, есть ли в домене действующие почтовые серверы (MX-записи).
remaining_credits	Количество кредитов API, оставшихся на вашем счету

Черный список / Белый список: Только поле block отражает принадлежность к списку. Черный список → block: true; белый список → block: false; не в белом списке (если включено) → 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.

Адрес электронной почты или домен

Попробуйте с:

Пакетная верификация

Проверка нескольких адресов электронной почты или доменов в одном запросе (не более 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.

Адреса электронной почты или домены

Попробуйте использовать разные домены:

Проверка только на поставку

Быстрая проверка доставляемости электронной почты с использованием MX и SMTP-проверки без внешних вызовов API. Возвращает только поля, связанные с доставкой, для ускорения отклика.

Конечная точка

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. Смотрите на него, чтобы решить, блокировать ли email/домен по вашим спискам:

trueEmail или его домен в чёрном списке → block: true. Добавление домена блокирует все адреса на нём.

trueБелый список включён, но email/домена в нём нет → block: true.

falseБелый список включён и email или его домен в нём есть → block: false.

—Ни один список не сработал → block по результату обычной проверки.

Обзор

✘

Чёрный список

Всегда блокировать указанные адреса или целые домены. Например, добавление example.com в чёрный список значит, что любой адрес @example.com вернёт block: true — независимо от результата проверки.

✔

Белый список

Разрешать только указанные адреса или домены. При включённом белом списке только записи из него получают block: false — всё остальное block: true. Например, добавление gmail.com разрешает любые @gmail.com, а [email protected] будет заблокирован. При выключении белый список не учитывается.

Можно добавить полный email ([email protected]) или домен (example.com). Добавление домена действует на все адреса этого домена. Регистр не учитывается.

Как это работает

Порядок проверки

Сначала чёрный список — Если адрес или его домен в чёрном списке — результат block: true. Дальнейшая логика списков не применяется.

Белый список (если включён) — Если email/домен в белом списке → block: false. Если нет → block: true.

Белый список выключен — Учитываются только чёрный список и обычная проверка.

Чёрный список всегда имеет приоритет: адрес из чёрного списка остаётся заблокированным даже при наличии в белом.

Что проверяется

Проверка email — API сверяет и полный адрес, и домен с обоими списками. Совпадение по любому применяет правило списка.

Проверка домена — с чёрным и (при включённом) белым списком сверяется только домен.

Краткая справка

Белый список вкл.	В чёрном списке	В белом списке	значение block
Нет	Да	—	`true`
Нет	Нет	—	Обычно
Да	Да	Любое	`true`
Да	Нет	Да	`false`
Да	Нет	Нет	`true`

Эндпоинты списков

Для всех эндпоинтов списков нужен заголовок: X-API-Key: your-api-key

Чёрный список

GET/v1/blacklist

Список записей чёрного списка

POST/v1/blacklist

Добавить email или домен · { "value": "..." }

DELETE/v1/blacklist

Удалить запись · value=...

Белый список

GET/v1/whitelist

Список записей белого списка

POST/v1/whitelist

Добавить email или домен · { "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

Добавить email или домен

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

Добавить email или домен

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: допустимый формат, напр. [email protected]
example.com — Домен: допустимый формат, напр. example.com

Недопустимые значения отклоняются с 400. Записи хранятся в нормализованном виде. Дубликаты объединяются в одну.

Где применяются списки

Правила списков применяются после проверки. В поле block в ответах одиночной и пакетной проверки email и проверки домена уже учтены чёрный и белый списки пользователя.

Сервер MCP (интеграция агентов искусственного интеллекта)

Интегрируйте проверку электронной почты непосредственно в агенты искусственного интеллекта, такие как Cursor и Claude Desktop, с помощью протокола Model Context Protocol (MCP). Ваш помощник по искусственному интеллекту может проверять электронные письма, проверять домены и синтаксис, не выходя из редактора.

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, одноразового использования, конфиденциальности и возможности доставки.	{ email: string }	1
verify_domain	Полная проверка домена, включая MX-записи, одноразовость, конфиденциальность и обнаружение "подвохов".	{ domain: string }	1
check_deliverability	Быстрая проверка доставки только с помощью MX и SMTP-верификации без внешних вызовов API	{ email: string }	1
verify_batch	Пакетная проверка до 100 электронных писем или доменов за один запрос	{ inputs: string[] }	1 per item
validate_email_syntax	Быстрая локальная проверка синтаксиса по RFC 5322 без сетевых вызовов	{ email: string }	0 (free)