Proper Check

Service

Email verification API

Connect a signup form, SaaS product, or CRM. REST API with Bearer key and OpenAPI documentation.

  • OpenAPI
  • API keys in dashboard
  • Bulk and single endpoints
REST · POST /api/v1/verify
curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@company.com"}'

Why use a verification API?

Real-time verification protects signup forms from typos, fake accounts, and disposable email. Your database stays clean from day one.

Self-serve: create an account, upload a list or connect the API without a sales call.

Main endpoints

Authorization via Authorization: Bearer ev_live_… header.

  • POST /api/v1/verify - single address
  • POST /api/v1/bulk - array of addresses
  • GET /api/v1/bulk/:id - job status
  • GET /api/v1/credits - credit balance

Key management

Create multiple API tokens, rotate them, and disable individual keys without affecting the rest of your integration. Each key can serve a different environment: production, staging, bulk cron.

Latency and timeouts

Typical response time is a few seconds. Mail servers sometimes respond slowly or use greylisting — then the status may be unknown. On signup forms, show a spinner and avoid blocking the user longer than 8–10 seconds.

API error codes

401 — missing or invalid token. 402 — no credits. 422 — invalid email in payload. 429 — rate limit. Full specification in the OpenAPI documentation.

  • 401 Unauthorized — check Authorization: Bearer header
  • 402 Payment Required — top up credits in the dashboard
  • 422 Unprocessable — fix email format in JSON
  1. Create a token

    Dashboard → API → generate a Bearer key.

  2. Call verify

    POST with JSON {"email":"user@company.com"}.

  3. Handle the result

    Valid → save the lead. Invalid → show an error in the form.

We cleaned 40k leads before a cold email push. Bounce dropped from 9% to under 1% — domain reputation recovered.

Marta, B2B SaaSVerified customer

We upload a CSV from CRM every week. Export with statuses saves hours of manual checking.

Tomasz, outbound agencyVerified customer

Trial credits were enough to judge quality. Then we bought a pack for our B2B newsletter.

Kamil, marketing automationVerified customer

Related

Frequently asked questions

What is the API latency?

Typically seconds. It depends on the recipient mail server and current load.

What happens when credits run out?

The API returns a 402 error. Top up credits in the dashboard.

Can I test the API for free?

After signup you get free test credits. Use them on staging before production.