Email verification API
EmailRazor offers an API interface you can use to validate emails.
API endpoint is the following:
https://emailrazor.com/v1/checkEmail?apikey=YOUR_API_KEY&email=EMAIL_TO_VERIFY
API can be called with a simple GET call, passing two parameters:
- apikey: personal API Key. You find the api key in your EmailRazor profile page.
- email: email address to verify.
Each successful api call consumes one credit on your EmailRazor credit balance.
Credit balance is re-computed every few minutes.
API replies with a json that contains a 'status' field, if status field value is equal to
ERROR it means that the api call is unsuccessful and you can find more details in the
error field of the json.
If the API call is successfull, status field contains
OK and the json contains the following data:
- email: the original email address you provided.
- normalized: Normalized form of the email address, usually it's just lowercase version of the address itself, but there also other cases specific to the destination domain.
- user: username part of the address.
- domain: domain part of the address.
- format: is this address formally valid or invalid? 'valid' means the address is formally valid, otherwise this field is se to 'no'. If address is not valid no further validation is executed.
- role: is this a role email (like staff@, info@, ...).
- mx: does domain has mail exchange (MX) nodes defined (defined/not set)? If domain has no mail exchange addresses declared, it cannot receive mail and no other validation is performed.
- free: domain is known to provide email addresses for free (true/false).
- disposable: domain is known to provide disposable (temporary) mailboxes (true/false).
- catchall: domain accept all addresses without telling whether they are defined or not (yes/no).
- smtp: mailbox verification result, true: SMTP check ok, or false: mailbox does not exist on destination domain.
- smtpstatus: A string containing additional details about DSTP verification. Sometime it can contain temporary warnings (lime mailbox full) or other mailbox conditions.
- md5: md5 code of lowercase of the original email address
- sha256: sha2-256 code of lowercase of the original email address
- score: Overall address score. You should usually remove from your list all addresses that go below score 0.4 since these addresses are not existent, not responsive or with high probabilty of being fake addresses or spamtraps.
- status: call status: it contains OK if everything went well, or ERROR in case the call failed.
- result: final result, it can be deliverable, underliverable or risky.
- elapsed: time in millisecond the system took to reply.
API call sample
Take a look at the following example API request URL:
https://emailrazor.com/v1/checkEmail?apikey=YOUR_API_KEY&email=test@example1.com
(If you would like to try it yourself, subscribe to EmailRazor and get some free credit)
The example of API call above would get the following answer:
{
"email":"test@example1.com",
"md5":"908895b8e55e8a914f61f88bc15f72b7",
"sha256":"39536741e082add5c9f94ce2395b72b489e198b9c8bffe1ee93cdd7467ac5359",
"normalized":"test@example1.com",
"user":"test",
"domain":"example1.com",
"role":true,
"format":"valid",
"mx":"defined (1)",
"free":false,
"disposable":false,
"catchall":false,
"smtp":false,
"smtpstatus":"warning: can't verify smtp",
"score":"0.30",
"result":"risky",
"status":"OK",
"elapsed":"179 ms"
}