Real Email Validation API – REV Lightning
Real Email Validation API- REV Lightning – uses GET/POST methods and supports only HTTPS with TLS v1.2+.
We recommend limiting the API call rate to 10 per second. Check out the complete list of RealPhoneValidation API best practices here: realphonevalidation.com/api-best-practices/
Required Input Parameters:
| Parameter | Description |
|---|---|
| Output | (OPTIONAL) set to “json” or “xml”. Omitting this defaults to XML |
| 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) |
| reachable | Y = Email can be delivered to an individual address. N = Cannot be reached. ? = Unknown |
| accept_all | Y = Domain accepts delivery to any address. N = Domain only accepts explicit accounts. ? = Unknown |
| disposable | Y = Email is detected as disposable or temporary. N = Email is not. |
| free | Y = Email is from a known free service. N = Email is not. |
| isp | Y = Email is given to internet service customers. N = Email is not. |
| caution | Y = Email service MAY be used for fraudulent or suspicious activity. N = Email did not show extra signs of suspicion. |
Example: Successful Request
https://api.realvalidation.com/rpvWebService/RealEmailLightning.php?email=dayehe6507z2@kaoing.com&token=12345-6789-1234-12345678Result in XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
<retval>0</retval>
<error_text></error_text>
<id>79-C</id>
<email>dayehe65@kaoing.com</email>
<accept_all>N</accept_all>
<disposable>Y</disposable>
<free>N</free>
<isp>N</isp>
<caution>Y</caution>
<reachable>Y</reachable>
</response>Result in JSON
{
"retval":"0",
"error_text":"",
"id":"79",
"email":"dayehe65@kaoing.com",
"accept_all":"N",
"disposable":"Y",
"free":"N",
"isp":"N",
"caution":"Y",
"reachable":"Y"
}Example: Unsuccessful Request
https://api.realvalidation.com/rpvWebService/RealEmailLightning.php?email=dayehe6507z2kaoing.com&token=12345-6789-1234-12345678Result in XML
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
<retval>-1</retval>
<error_text>invalid email address format</error_text>
</response>Result in JSON
{
"retval" : "-1",
"error_text" : "invalid email address format",
}Appendix A:
| Retval Code | Error_text | Description |
|---|---|---|
| -1 | Unauthorized | Token not provided |
| -1 | Invalid email address format | The email address is not formatted properly |
| -1 | The email address is not formatted properly | 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 is not formatted properly |
