Sandbox Mode
QuickEmailVerification single email verification API sandbox mode helps developers to test their integration against simulated results. Requesting against the sandbox endpoint is totally free and no credits will be deducted from actual credit quota.
Sandbox API responses are designed to help users understand various possible results which may return from our single email verification API endpoint. All responses of sandbox requests are mock and pre-defined.
API endpoint
GET https://api.quickemailverification.com/v1/verify/sandbox
Request parameters
Following parameters are required as query string for this API endpoint.
apikey | string | Required | Your secret API key to authenticate the request. |
string | Required | An email address to be tested. |
Valid
The default result of single verification API sandbox request is "valid". So if the provided email format does not match with any of the following email formats, it will always return "valid".
Format to simulate "Valid" result
Format | Example |
---|---|
valid@* | valid@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=valid@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"true",
"accept_all":"true",
"role":"false",
"free":"false",
"email":"valid@example.com",
"user":"valid",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Safe To Send
Format to simulate "Safe To Send" result
Format | Example |
---|---|
safe-to-send@* | safe-to-send@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=safe-to-send@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"safe-to-send@example.com",
"user":"safe-to-send",
"domain":"example.com",
"safe_to_send":"true",
"did_you_mean":"",
"success":"true",
"message":""
}
Free
Format to simulate "Free" result
Format | Example |
---|---|
free@* | free@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=free@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"true",
"email":"free@example.com",
"user":"free",
"domain":"example.com",
"safe_to_send":"true",
"did_you_mean":"",
"success":"true",
"message":""
}
Rejected Email
Format to simulate "Rejected Email" result
Format | Example |
---|---|
rejected-email@* | rejected-email@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=rejected-email@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"rejected_email",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"rejected-email@example.com",
"user":"rejected-email",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Invalid Domain
Format to simulate "Invalid Domain" result
Format | Example |
---|---|
invalid-domain@* | invalid-domain@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=invalid-domain@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"invalid_domain",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"invalid-domain@example.com",
"user":"invalid-domain",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Invalid Email
Format to simulate "Invalid Email" result
Format | Example |
---|---|
invalid-email@* | invalid-email@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=invalid-email@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"invalid_email",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"invalid-email@example.com",
"user":"invalid-email",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Exceeded Storage
Format to simulate "Exceeded Storage" result
Format | Example |
---|---|
exceeded-storage@* | exceeded-storage@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=exceeded-storage@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"exceeded_storage",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"exceeded-storage@example.com",
"user":"exceeded-storage",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
No MX Record
Format to simulate "No MX Record" result
Format | Example |
---|---|
no-mx-record@* | no-mx-record@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=no-mx-record@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"no_mx_record",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"no-mx-record@example.com",
"user":"no-mx-record",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Did You Mean
Format to simulate "Did You Mean" result
Format | Example |
---|---|
did-you-mean@* | did-you-mean@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=did-you-mean@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"invalid",
"reason":"rejected_email",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"did-you-mean@example.com",
"user":"did-you-mean",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"did-you-mean@example.com",
"success":"true",
"message":""
}
Timeout
Format to simulate "Timeout" result
Format | Example |
---|---|
timeout@* | timeout@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=timeout@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"unknown",
"reason":"timeout",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"timeout@example.com",
"user":"timeout",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Unexpected Error
Format to simulate "Unexpected Error" result
Format | Example |
---|---|
unexpected-error@* | unexpected-error@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=unexpected-error@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"unknown",
"reason":"unexpected_error",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"unexpected-error@example.com",
"user":"unexpected-error",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
No Connect
Format to simulate "No Connect" result
Format | Example |
---|---|
no-connect@* | no-connect@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=no-connect@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"unknown",
"reason":"no_connect",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"no-connect@example.com",
"user":"no-connect",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Unavailable SMTP
Format to simulate "Unavailable SMTP" result
Format | Example |
---|---|
unavailable-smtp@* | unavailable-smtp@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=unavailable-smtp@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"unknown",
"reason":"unavailable_smtp",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"unavailable-smtp@example.com",
"user":"unavailable-smtp",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Temporarily Blocked
Format to simulate "Temporarily Blocked" result
Format | Example |
---|---|
temporarily-blocked@* | temporarily-blocked@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=temporarily-blocked@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"unknown",
"reason":"temporarily_blocked",
"disposable":"false",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"temporarily-blocked@example.com",
"user":"temporarily-blocked",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Accept All
Format to simulate "Accept All" result
Format | Example |
---|---|
accept-all@* | accept-all@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=accept-all@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"false",
"accept_all":"true",
"role":"false",
"free":"false",
"email":"accept-all@example.com",
"user":"accept-all",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Role
Format to simulate "Role" result
Format | Example |
---|---|
role@* | role@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=role@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"false",
"accept_all":"false",
"role":"true",
"free":"false",
"email":"role@example.com",
"user":"role",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Disposable
Format to simulate "Disposable" result
Format | Example |
---|---|
disposable@* | disposable@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=disposable@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"result":"valid",
"reason":"accepted_email",
"disposable":"true",
"accept_all":"false",
"role":"false",
"free":"false",
"email":"disposable@example.com",
"user":"disposable",
"domain":"example.com",
"safe_to_send":"false",
"did_you_mean":"",
"success":"true",
"message":""
}
Low Credit
This option will help user to simulate a situation where no verification credits are remaining in the account.
Format | Example |
---|---|
low-credit@* | low-credit@example.com |
Request
curl --get --include "https://api.quickemailverification.com/v1/verify/sandbox?email=low-credit@example.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"
Response
{
"success":"false",
"message":"Low credit. Payment required"
}