CheapVerifier

Developer

REST API documentation

A clean, no-nonsense REST API for verifying email addresses in real time or in bulk.

Get your API key
https://api.cheapverifier.com

Authentication

Authenticate every request with the x-api-key header. Generate a key from the dashboard under Settings → API.
curl -H "x-api-key: sk_live_***" \
  https://api.cheapverifier.com/v1/email-validation?email=user@example.com

Token usage

One credit per verdict. An address that comes back valid or invalid costs 1 credit. catch_all and unknown cost nothing — neither is an answer about the address. There are no premium or catch-all multipliers. Every response reports creditsUsed.

Rate limits

File upload: 10 requests/min. Status & detail endpoints: 60 requests/min. Limits are enforced per API key — exceeding them returns 429 Too Many Requests.

Endpoints

Every request is routed through HTTPS and authenticated via API key.

GET/v1/email-validation?email=&catchAll=&mode=

Verify one address. mode defaults to quick; advanced adds a slower confirmation pass that can recover more valid mailboxes when enabled.

curl "https://api.cheapverifier.com/v1/email-validation?email=user@example.com&catchAll=0&mode=quick" \
  -H "x-api-key: sk_live_***"
GET/v1/email-validation/status/:fileId

Poll a verification that did not finish inside the request. Returns billingStatus: "pending" until it settles.

curl https://api.cheapverifier.com/v1/email-validation/status/<fileId> \
  -H "x-api-key: sk_live_***"
POST/v1/file/upload

Upload a CSV for bulk verification. Add mode=advanced as a multipart field for the slower confirmation pass; quick is the default.

curl -X POST https://api.cheapverifier.com/v1/file/upload \
  -H "x-api-key: sk_live_***" \
  -F "file=@emails.csv" \
  -F "catchAll=false" \
  -F "mode=quick"
GET/v1/task/status/:taskId

Poll the status of a bulk verification job.

curl https://api.cheapverifier.com/v1/task/status/<taskId> \
  -H "x-api-key: sk_live_***"
GET/v1/task/details/:fileId

Page through verified results for a completed file.

curl "https://api.cheapverifier.com/v1/task/details/<fileId>?page=1" \
  -H "x-api-key: sk_live_***"

Need help? We're happy to walk you through the integration.

Contact us