Email Verification API Documentation
The RealPhoneValidation – Email Verification API uses GET/POST methods and supports only HTTPS with TLS v1.2+.
Required Input Parameters:
| Parameter | Description |
|---|---|
| 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-123456ABCDEFResult 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-123456ABCDEFResult 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 fomat | The email address is 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 | invalid email address format | The email address not formatted properly |
| 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 | The email represents a real account/inbox available at the given domain |
