Meghly Send
Validate guide
Check whether an email address can receive mail with the Validate API: single and bulk checks, answers and reasons, credits, the sandbox and limits.
Validate is part of Meghly Send. It checks whether an address is likely to receive mail, before you send to it.
Keys and credits
Make a Validate key (yvk_…) on the Validations page. It cannot send mail, and Send keys cannot validate.
Every account gets 100 free credits each UTC day. They are used first, then bought credits, which never expire. An answer of unknown costs nothing. Buying credits in the dashboard is not available yet.
One address
curl "https://api.meghlycloud.com/v1/verify?email=jane@example.org&apikey=yvk_your_key"| Field | Meaning |
|---|---|
result | valid, invalid or unknown |
reason | Why, for example accepted_email, rejected_email, invalid_domain, no_mx_record, timeout |
disposable | A throw-away address |
accept_all | The domain accepts every address, so a positive answer proves little |
role | A group address such as info@ |
free | A free-mail provider |
safe_to_send | Our overall advice |
did_you_mean | A likely correction of a typo |
The header X-QEV-Remaining-Credits on every answer shows your credits left. Add &compat=qev to get every value as a string, for integrations written for that shape.
Bulk
POST /v1/bulk-verify takes a CSV of up to 100,000 addresses (20 MB) and needs credits for every row up front. Read progress with GET /v1/bulk-verify/status/{id} and download results with GET /v1/bulk-verify/report/{id}?type=safe_to_send. A callback address (https only) is notified when the job finishes. Results are kept for 30 days.
Sandbox
GET /v1/verify/sandbox?email=valid@example.com&apikey=… is never charged. The part before the @ picks the answer, for example valid, disposable, role, accept-all, rejected-email, invalid-domain, timeout.
Limits
300 requests per minute per key, then 429 with Retry-After. One address is given 15 seconds by default (timeout from 3 to 30).
What unknown means
Some servers time out, refuse to answer, or accept everything. The honest answer is then unknown. Send to unknown addresses in small batches and watch your bounce rate.