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

bash
curl "https://api.meghlycloud.com/v1/verify?email=jane@example.org&apikey=yvk_your_key"
FieldMeaning
resultvalid, invalid or unknown
reasonWhy, for example accepted_email, rejected_email, invalid_domain, no_mx_record, timeout
disposableA throw-away address
accept_allThe domain accepts every address, so a positive answer proves little
roleA group address such as info@
freeA free-mail provider
safe_to_sendOur overall advice
did_you_meanA 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.

Stuck?

Talk to our engineers directly — by phone or email.

01782618248shohag.meghly@gmail.com