Learn More About API Sandbox Testing

API SANDBOX

At the beginning of 2017, an API sandbox was implemented.

The purpose of this was to implement a method of testing API keys – a simulation of the real-time API, without having to login and create an account.

There is no delay when using this sandbox and it does not do any actual verification. It is intended to allow clients to quickly test their API integration before using a live key and therefore any paid credits.

HTTP requests are redirected to HTTPS, secured by Let’s Encrypt.

USAGE

The format to call the sandbox is:

https://sandbox01.emailverifyapi.com/api/a/v1?key=sandboxkey01&email=

The responses are hard coded based on the email address used:

For example: bad-mailboxdoesnotexist@sandbox.company.com

returns Bad/MailboxDoesNotExist

If any unexpected email address is supplied we simply return OK/Success.

Email Checker

Give Email Checker a quick test today by using our online testing service below to experience our spreed and accuracy.

Test Drive Email Checker
SUPPORTED RETURN CODES

The following return codes are supported for the status and additionalStatus parameters of the email address construct as per [status]-[additionalStatus]@sandbox.company.com.

ok-success
bad-mailboxdoesnotexist
bad-domainisinexistent
bad-nomxserversfound
bad-atsignnotfound
unknown-transientnetworkfault
unknown-serveriscatchall
unknown-domainiswellknowndea
unknown-mailboxfull
unknown-serverdoesnotsupportinternationalmailboxes
unknown-possiblespamtrapdetected

REAL LIFE EXAMPLE

Call

https://sandbox01.emailverifyapi.com/api/a/v1?key=sandboxkey01&email=bad-mailboxdoesnotexist@sandbox.company.com

Result

{“status”:”Bad”,”additionalStatus”:”MailboxDoesNotExist”,
“emailAddressProvided”:”bad-mailboxdoesnotexist@sandbox.company.com”,
“emailAddressChecked”:”bad-mailboxdoesnotexist@sandbox.company.com”,
“emailAddressSuggestion”:””}

EMAIL ADDRESS CORRECTION

An additional parameter can be passed to the URL to force the API to suggest corrections to a standard format email address.

Call

https://sandbox01.emailverifyapi.com/api/a/v1?key=sandboxkey01&email=mytest@hotmal.com&correct=1

Result

{“status”:”Ok”,”additionalStatus”:”Success”,”emailAddressProvided”:
“mytest@hotmal.com”,”emailAddressChecked”:”mytest@hotmal.com”,
“emailAddressSuggestion”:”mytest@hotmail.com”}