Our API to verify e-mail addresses is really easy to use with cURL


curl --get --include 'https://mailcheck.p.mashape.com/?domain=DOMAIN-OR-EMAIL' \
-H 'X-Mashape-Key: YOUR-API-KEY' \
-H 'Accept: application/json'

This will return a JSON-array with information about the domain, and if you should block it or not.


For example, say you want to verify the e-mail address [email protected], to see if you should allow that e-mail to register an account, or sign up for your newsletter.

Your code would look something like this:

curl --get --include 'https://mailcheck.p.mashape.com/[email protected]' \
-H 'X-Mashape-Key: YOUR-API-KEY' \
-H 'Accept: application/json'

You can of course just send it as a regular GET-request to that URL also, in your favorite way, as long as you have the API-key in the header.

You will receive a JSON response, telling you if this is a disposable e-mail to block, or if there are other issues with the domain:

   "valid": true,
   "block": true,
   "disposable": true,
   "domain": "tmail.ws",
   "text": "Disposable e-mail",
   "reason": "Heuristics (2a)",
   "mx_host": "tmail.ws",
   "mx_info": "Using MX pointer tmail.ws from DNS with priority: 0",
   "mx_ip": ""

This will tell you if you should block the domain tmail.ws or not, and the reason to why the API thinks so (disposable e-mail, etc).

To get started for free, and get an API key, click here!