Black Friday Sale

Use code: BLACKFRIDAY50

50% OFF on all prices
Ends in: 00d: 00h: 00m: 00s

Verify emails in real time right from your app

One REST call. A clear status, a score and the reason why.

100 free credits · No credit card required · JSON over HTTPS

Works with any language that speaks HTTP

PythonNode.jsPHPRubyGoJavaPythonNode.jsPHPRubyGoJava
How it works

Live in three steps

Step 1

Create your API key

Sign up and create a key in the dashboard. It starts with mv_live_.

POST /api/v1/verify/single
Step 2

Send one request

POST the email with your key in the X-API-Key header.

Step 3

Act on the answer

Send to valid, drop invalid, and pick your own rule for catch-all.

The response

Every answer comes with the reason why

The full response from /verify/single. Pick a question to see the field that answers it.

Endpoints

What you can do with the API

Grouped by the job they do. Only verification results cost credits.

01Verify one address

  • Check one email in real timePOST/api/v1/verify/single
    1 credit

02Verify a list

  • Send up to 10,000 emails in one jobPOST/api/v1/verify/bulk
    1 credit / result

03Manage jobs

  • See a job's progress and resultsGET/api/v1/verify/bulk/{job_id}
    Free
  • List all your jobsGET/api/v1/verify/bulk
    Free
  • Download results as CSV or JSONGET/api/v1/verify/bulk/{job_id}/download
    Free
  • Cancel a job and get reserved credits backDELETE/api/v1/verify/bulk/{job_id}
    Free

04Account & feedback

  • Check your credit balanceGET/api/v1/credits
    Free
  • Tell us which emails bounced or deliveredPOST/api/v1/webhooks/bounce
    Free

Unknown results are always free. Authenticate every call with X-API-Key. Full API reference

In production

Signed webhooks, clear limits, big jobs

Webhooks

Signed with HMAC-SHA256

Get a POST when a bulk job finishes. Check the signature before you trust it.

# header: X-Mailvalid-Signature
expected = hmac.new(
    secret.encode(), raw_body,
    hashlib.sha256).hexdigest()
ok = hmac.compare_digest(
    expected, signature)
Rate limits

200 requests a minute on paid plans

Status and balance checks have their own, higher limit.

Free 10 / min
Paid plans 200 / min
Bulk

Whole lists in one call

Submit a list, then poll the job or wait for the webhook.

10,000emails per job on paid plansFree plan: 100 per job
Fair billing

You only pay for real answers

Every response says what it cost in credits_used. Three sample calls:

anna@northwind.io valid "credits_used": 1
tom@gmial.con invalid "credits_used": 1
ops@slow-mx.net unknown = free unknown "credits_used": 0
3 calls 2 credits charged

When a mail server gives no definite answer, the result is unknown and you are not charged.

  • From $0.001196 per email
  • Duplicates in a bulk job are free
  • Credits never expire
See pricing
FAQ

Questions about the API

How much does an API call cost?

1 credit per definitive result: valid, invalid, catch_all or do_not_mail. An unknown result costs nothing, and every response includes credits_used so you can see the exact charge. Credits never expire, and you get 100 free credits when you sign up.

What are the rate limits?

The free plan allows 10 verification requests per minute. Every paid plan (MailValid Plus or pay-as-you-go) allows 200 per minute. Reading job status and your credit balance has its own, higher limit, so polling does not eat into your verification budget.

How many emails can I send in one bulk job?

Up to 10,000 emails per job on any paid plan, and 100 on the free plan. Duplicate addresses in the same job and unknown results are not charged.

How do I check that a webhook really came from MailValid?

Every webhook carries an X-Mailvalid-Signature header: the HMAC-SHA256 of the raw request body, hex-encoded, signed with your webhook secret. Compute the same HMAC on your side and compare the two with a constant-time check.

Which languages can I use?

Any language that can send an HTTPS request. Authenticate with your API key in the X-API-Key header and send JSON. The API docs include copy-paste examples in cURL, Python, JavaScript (Node.js) and PHP.

Your first 100 verifications are on us

Create a key, paste one cURL command and get a real status back. No credit card needed.

Get your free API key