Інтегруйте перевірку email у ваші додатки через REST API.
Усі запити до API потребують Bearer-токен у заголовку Authorization. Можна використовувати JWT (з логіну) або API-токен (створений у панелі).
Перевірити одну email-адресу. Вартість: 1 токен.
Надішліть список email для перевірки. Вартість: 1 токен за email.
Якщо вам зручніше інтегруватися через npm package, а не збирати raw HTTP requests вручну, використовуйте community package для mails.expert і стартуйте з чистішого integration setup.
Відкрийте сторінку пакета в новій вкладці, щоб переглянути usage, версії та деталі встановлення.
Усі запити до API потребують Bearer-токен у заголовку Authorization. Можна використовувати JWT (з логіну) або API-токен (створений у панелі).
Authorization: Bearer YOUR_TOKENAPI-токени починаються з префікса mv_.
Перевірити одну email-адресу. Вартість: 1 токен.
POST /v1/verify
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"email": "test@example.com"
}{
"email": "test@example.com",
"result": "valid",
"checks": {
"format": true,
"domainExists": true,
"hasMx": true,
"domainReachable": true,
"smtpStatus": "valid",
"isDisposable": false,
"isRole": false,
"isBlacklisted": false,
"isKnownProvider": true,
"isCatchAll": false
},
"reason": "250 2.1.5 OK"
}Надішліть список email для перевірки. Вартість: 1 токен за email.
POST /v1/bulk-verify
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"emails": [
"user1@example.com",
"user2@example.com",
"info@company.com"
]
}
// Response:
{
"jobId": "abc-123",
"queued": 3
}GET /v1/bulk-verify/abc-123/progress
Authorization: Bearer YOUR_TOKEN
// Response:
{
"job_id": "abc-123",
"status": "processing",
"total": 3,
"processed": 2,
"progress_percent": 66
}GET /v1/bulk-verify/abc-123
Authorization: Bearer YOUR_TOKEN
// Response:
{
"id": "abc-123",
"status": "completed",
"total": 3,
"processed": 3,
"results": [
{ "email": "user1@example.com", "result": "valid" },
{ "email": "user2@example.com", "result": "invalid" },
{ "email": "info@company.com", "result": "catch_all" }
]
}Кожна відповідь включає детальні результати перевірок:
format — Email format is valid
domainExists — Domain exists (DNS resolves)
hasMx — Domain has MX records
domainReachable — Domain web server responds
smtpStatus — SMTP RCPT TO result: valid / invalid / unknown
isDisposable — Temporary/disposable email provider
isRole — Role-based address (admin@, info@, support@...)
isBlacklisted — Found on spam blacklists
isKnownProvider — Known trusted provider (Gmail, Yahoo, etc.)
isCatchAll — Domain accepts all addresses (catch-all)curl -X POST https://api.mails.expert/v1/verify \
-H "Authorization: Bearer mv_your_api_token" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'curl -X POST https://api.mails.expert/v1/bulk-verify \
-H "Authorization: Bearer mv_your_api_token" \
-H "Content-Type: application/json" \
-d '{"emails": ["a@example.com", "b@example.com"]}'API-запити обмежені за кількістю на користувача. При перевищенні ліміту ви отримаєте код 429. Зверніться до підтримки для збільшення лімітів.