Email Verification API Documentation

Test our email validation tool here

The RealPhoneValidation – Email Verification API uses GET/POST methods and supports only HTTPS with TLS v1.2+.

Required Input Parameters:
Parameter
Description
email
email address to verify
token
unique PW given by RealValidation
Response Fields:
Response Field
Description
retval
(See appendix A below)
error_text
(See appendix A below)
status
(See appendix A below)
connected
“Y” for yes, “N” for no (See appendix A below)
disposable
“Y” for yes, “N” for no (See appendix A below)
Example: Successful Request
https://api.realvalidation.com/rpvWebService/EmailVerify.php?email=johnsmith@test.com&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
  <retval>0</retval>
  <error_text></error_text>
  <id>2-C</id>
  <status>valid</status>
  <error_code></error_code>
  <error></error>
  <connected>N</connected>
  <disposable>N</disposable>
</response>
Example: Unsuccessful Request
https://api.realvalidation.com/rpvWebService/EmailVerify.php?email=johnsmith@test.com.com&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version=”1.0” encoding=”UTF-8”?>
  <response>
  <retval>-1</retval>
  <error_text>invalid email address format</error_text>
</response>
Appendix A:
Retval Code
ResponseMsg
Description
-1
Unauthorized
Token not provided
-1
Invalid email address format
Email address not formatted properly
-1
Server-unavailable
Server issue -- try again
-1
Timeout
The response did not come back within the required time
0
Good Response
102
The user is invalid (double-check credentials).
Invalid credentials
Variable
Value
Description
connected
“Y” for yes, “N” for no
Whether or not a valid email is connected to active online networks
status
valid
The email represents a real account / inbox available at the given domain
status
invalid
Not a real email
status
unknown
These are domains that respond to every verification request in the affirmative, and therefore cannot be fully verified.
status
accept_all
Good Response
error code
email_address_invalid
The email is not formatted correctly
error code
email_domain_invalid
The domain does not exist or is not capable of receiving email
disposable
“Y” for yes, “N” for no
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.

Not super techie... integrate Email Verification into your favorite CRM, forms, and apps using Zapier or Integrately.

Email Verification API Doc
Email Verification API 060922