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

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

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

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

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

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

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

GET /v1/verify

Параметры

Имя	Тип	Требуется	Описание
input	string	Да	Адрес электронной почты или домен для проверки (например, test@example.com или 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": "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

Для проверки конечных точек вам понадобится ключ 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": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

Попробуйте

Ключ API

Для проверки конечных точек вам понадобится ключ API.

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

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

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

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

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

GET /v1/verify/deliverable

Параметры

Имя	Тип	Требуется	Описание
input	string	Да	Адрес электронной почты для проверки возможности доставки (например, 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

Для проверки конечных точек вам понадобится ключ 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, а user@yahoo.com будет заблокирован. При выключении белый список не учитывается.

Можно добавить полный email (user@example.com) или домен (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 }

Формат значения

user@example.com — Email: допустимый формат, напр. user@example.com
example.com — Домен: допустимый формат, напр. example.com

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

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

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

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

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

Настройка

Добавьте следующую конфигурацию в файл конфигурации .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)