Proper Check
Developer Hub · REST API v1

API верифікації email-адрес

Перевіряйте розсилки програмно — менше bounce, краща доставлюваність

Підключіть форми, CRM і лендінги до EmailVerifier. Перевіряйте email через REST API в реальному часі або bulk job — прозора модель 1 запит = 1 кредит.

  • Верифікація real-time
  • Bulk до 50 000 адрес
  • 1 запит = 1 кредит
Згенерувати API-ключСтворити акаунтOpenAPI / Redoc

Приклад запиту

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

База знань API

Оберіть тему — від авторизації та кредитів до bulk, webhook і кодів помилок.

APIAPI верифікації email

POST /verify — одна адреса, результат за секунду, статус valid/invalid/risky.

Детальніше
APIBulk верифікація email

Масова перевірка CSV — job, прогрес і експорт результатів.

Детальніше
APIКредити та оплата

Баланс, використання API, 1 кредит = 1 верифікація, HTTP 402.

Детальніше
APIAPI-ключі та авторизація

Bearer ev_live_, панель токенів, безпечне зберігання ключа.

Детальніше
APIWebhook та інтеграції

verification.completed, HMAC-підпис, CRM і маркетинг.

Детальніше
APIДовідник OpenAPI

Повна специфікація YAML, Redoc і каталог помилок HTTP.

Детальніше

Що таке API верифікації email?

REST-інтерфейс для валідації адрес перед розсилкою.

Email Verification API перевіряє, чи існує адреса, чи домен приймає пошту, чи скринька не disposable чи catch-all. Ви зменшуєте bounce rate, захищаєте репутацію відправника та покращуєте deliverability.

API працює через HTTPS на /api/v1. Авторизація — Bearer-ключ (ev_live_…) або сесія панелі. Кожен успішний POST /verify коштує 1 кредит — без підписки та прихованих платежів за GET.

Коли використовувати API верифікації email

Типові сценарії інтеграції в B2B і маркетингу.

Форми реєстрації

Валідуйте email у реальному часі — відхиляйте invalid і disposable до додавання в базу.

CRM і ліди

Очищуйте ліди з лендінгів — у pipeline потрапляють лише коректні адреси.

Гігієна списків перед кампанією

Bulk API перед newsletter — менше відмов, вищий open rate.

SaaS-платформи

Вбудуйте перевірку email у продукт — кредитна модель спрощує тарифи для клієнтів.

Модель кредитів API

Просте ціноутворення: один запит верифікації = один кредит.

  • POST /verify списує 1 кредит за кожен успішний запит (HTTP 200) з ключем ev_live_, навіть якщо адресу вже перевіряли через API. Sandbox-ключі (ev_test_) повертають mock без списання кредитів.
  • Операції GET — баланс, історія, статус bulk, експорт CSV — безкоштовні.
  • Недостатній баланс → HTTP 402 (insufficient_credits). Помилка рушія (503) не списує кредит.

Авторизація та API-ключі

Безпечний доступ через заголовок Authorization.

  1. Увійдіть у панель і відкрийте Токени API (/konto/api).
  2. Створіть продакшн-ключ (ev_live_) або sandbox (ev_test_) у панелі — повний secret видно лише раз.
  3. Надсилайте ключ у Authorization: Bearer ev_live_… — ніколи в URL чи на клієнті.
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Швидкий старт — email verification API

Два виклики: баланс і перша верифікація.

1. Перевірити баланс кредитів

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Верифікувати одну email-адресу

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Одиночна верифікація (real-time)

POST /api/v1/verify приймає JSON з полем email. Відповідь містить status, score 0–100, provider і enrichment (MX, catch-all).

POST /api/v1/verify

Структура JSON-відповіді

Поля після успішної верифікації.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

Статуси верифікації email

Класифікація в API, панелі та CSV.

valid

valid — адреса існує і приймає пошту; безпечно для відправки.

invalid

invalid — адреси немає або домен без пошти; видаліть зі списку.

risky

risky — низька впевненість (disposable, role account); обережно в кампанії.

catch_all

catch_all — сервер приймає всі адреси домену; вищий ризик bounce.

unknown

unknown — неоднозначна відповідь SMTP; можлива повторна перевірка.

Довідник REST-ендпоінтів

Повний список шляхів API v1 з вартістю в кредитах.

МетодШляхКредитиОпис
POST/verify1Одиночна верифікація в реальному часі
GET/verify/:id0Результат за verificationId
GET/verifications0Історія та статистика за 30 днів
GET/credits0Поточний баланс кредитів
POST/bulkNСтворення bulk job (N кредитів)
GET/bulk/:id0Статус і прогрес bulk job
GET/bulk/:id/export0Завантаження результатів CSV
GET/POST/PATCH/DELETE/api-keys0Керування токенами API (сесія)
GET/POST/DELETE/webhooks0Налаштування webhook (сесія)
GET/usage0Статистика використання API та кредитів

Bulk email verification API

Перевірка тисяч адрес в одному job — ідеально перед великою кампанією.

  1. POST /bulk з масивом emails або CSV — кредити за N унікальних адрес.
  2. GET /bulk/:id — polling статусу (queued → processing → completed).
  3. GET /bulk/:id/export — CSV з колонками email, status, score, provider.
curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Webhook — verification.completed

POST на ваш URL після верифікації. Заголовок X-EV-Signature — HMAC-SHA256 тіла; перевіряйте підпис перед обробкою.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Ліміти запитів (rate limiting)

За замовчуванням 60 запитів на хвилину на API-ключ. Перевищення → HTTP 429 з rate_limit_exceeded. Ліміти per key — окремі токени для інтеграцій.

Опційний заголовок для POST /verify — безпечний retry без подвійного списання кредиту (TTL 24 год).

X-Request-Id

Кожна відповідь містить X-Request-Id — вкажіть його в зверненні до підтримки при налагодженні інтеграції.

HTTP-коди помилок

HTTPКодОпис
401unauthorizedНемає сесії або API-ключа в запиті.
401invalid_api_keyНедійсний, прострочений або анульований ключ.
400invalid_requestНевірний JSON, відсутнє поле email або некоректний формат.
402insufficient_creditsНедостатньо кредитів — поповніть у /konto/kredyty.
429rate_limit_exceededПеревищено ліміт 60 запитів/хв на API-ключ.
503engine_unavailableРушій верифікації недоступний — кредит не списується.

Приклади інтеграції

Той самий flow верифікації популярними мовами.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — API верифікації email

Найчастіші питання розробників і маркетологів.

OpenAPI 3.1 та Redoc

Машиночитна специфікація для codegen, контрактних тестів і CI.

Завантажити openapi-v1.yamlІнтерактивна довідка Redoc

Почніть верифікувати email через API

Безкоштовні тестові кредити після реєстрації. API-ключ у панелі за хвилину.

Створити акаунтТокени API

Згенеруйте ключ у панелі облікового запису.