Email Verification API
Our Real-Time API is a simple JSON based REST Web Service that allows developers to verify individual email addresses on demand as a user enters them in a web form or mobile application.
It is a simple HTTP GET request with two parameters:
1. address: the email address to be verified.
2. apikey: the api key for your MightyVerify account.
Here is an example request:
https://bpi.briteverify.com/emails.json?address=johndoe@briteverify.com&apikey=<your-ip-key>
Status
There are only 4 statuses for an email in MightyVerify.
1. Valid: The email represents a real account / inbox available at the given domain
2. Invalid: Not a real email
3. Unknown: For some reason we cannot verify valid or invalid. Most of the time a domain did not respond quickly enough.
4. Accept All: These are domains that respond to every verification request in the affirmative, and therefore cannot be fully verified.
Unless something goes wrong, the HTTP status code will always be 200, regardless if the email is valid or invalid. The above request would yield the following response.
{
"address": "johndoe@mightyverify.com",
"account": "johndoe",
"domain": "mightyverify.com",
"status": "valid",
"disposable": false,
"role_address": false,
"duration": 0.104516605
}
Now if I pass an invalid email I will get not only a status of "invalid", I will also get an error and and error code explaining why the email is invalid.
https://bpi.mightyverify.com/emails.json?address=james@yahoo.com&apikey=
{
"address": "james@yahoo.com",
"account": "james",
"domain": "yahoo.com",
"status": "invalid",
"error_code": "email_account_invalid",
"error": "Email account invalid",
"disposable": false,
"role_address": false,
"duration": 0.141539548
}
Response Attributes
address: the email that was passed
account: the inbox or account parsed from the email
domain: the domain parsed from the email
status: the status of the given email address
error: the error message if the email is invalid
error_code: a code representation of error
disposable: is the email a temporary or "disposable" email address
role_address: the email is a role address such as sales or admin.
duration: the time it took to process your request
Error & Error Codes
The error is really just a humanized version of the error code. So that an error_code of "email_account_invalid" will have an error of "Email account invalid." The error in this sense is really the "error message," something intended to be displayed in a Web Form or application UI.
email_address_invalid: the email is not formatted correctly
email_domain_invalid: the domain does not exist or is not capable of receiving email
email_account_invalid: the email account does not exist on the domain
Disposable
A temporary or "disposable" email address is one that a user has set up to live for only a short period of time for a variety of reasons. Usually you don't want to accept these types of emails, but we leave that up to how you wish to implement your own applications. These emails are just like any other emails and the "status" will reflect that. However, the disposable flag will be present if the email is from a known temporary email provider.
{
"address": "james@yahoo.com",
"account": "james",
"domain": "veryhidden.com",
"status": "valid",
"disposable": true,
}
Role Addresses
Role address are email address that are set aside for functions, not people. They’re often forwarded to a group or department inside a company, and they can change owners frequently. Sending to a role address can quickly lead to spam complaints. Also, unused role accounts are often converted to spam traps, which will also get you into a ton of trouble. Either way, it’s a darn good idea to toss these aside. However, technically speaking, they can be "deliverable" addresses. So MightyVerify does not mark them as invalid. Instead we have a role_address flag to let you know to sending to the address is not advisable, but ultimately up to you.
Some examples of role addresses are postmaster, sales, admin, info, webmaster, etc. One role address in particular that is extremely risky is the postmaster address. Sending an email to that one is like driving drunk to a police station... not that mighty ;-)
{
"address": "sales@mightyverify.com",
"account": "sales,
"domain": "mightyverify.com",
"status": "valid",
"role_address": true,
}