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
Live in three steps

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

POST /api/v1/verify/singleSend one request
POST the email with your key in the X-API-Key header.

Act on the answer
Send to valid, drop invalid, and pick your own rule for catch-all.
Every answer comes with the reason why
The full response from /verify/single. Pick a question to see the field that answers it.
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 timePOST1 credit
/api/v1/verify/single
02Verify a list
-
Send up to 10,000 emails in one jobPOST1 credit / result
/api/v1/verify/bulk
03Manage jobs
-
See a job's progress and resultsGETFree
/api/v1/verify/bulk/{job_id} -
List all your jobsGETFree
/api/v1/verify/bulk -
Download results as CSV or JSONGETFree
/api/v1/verify/bulk/{job_id}/download -
Cancel a job and get reserved credits backDELETEFree
/api/v1/verify/bulk/{job_id}
04Account & feedback
-
Check your credit balanceGETFree
/api/v1/credits -
Tell us which emails bounced or deliveredPOSTFree
/api/v1/webhooks/bounce
Unknown results are always free. Authenticate every call with X-API-Key. Full API reference
Signed webhooks, clear limits, big jobs
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)
200 requests a minute on paid plans
Status and balance checks have their own, higher limit.
Whole lists in one call
Submit a list, then poll the job or wait for the webhook.
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
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
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