RPV Active API Documentation
The RPV Active API uses GET/POST methods and supports only HTTPS with TLS v1.2+. It determines the basic usability of a phone number. This means the phone number is active on a “still in business” phone service provider. Not to be confused with if a phone is “connected” to an actual customer. For that “connected” info, use the Turbo or Scrub APIs.
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 |
---|---|
Phone | 10 numeric digits ONLY |
Token | Unique PW given by RealValidation |
Response Fields:
Response Fields | Description |
---|---|
RESPONSECODE | (See Appendix A below) |
RESPONSEMSG | Can display a text message during certain errors |
Example: Active Phone Line
https://api.realvalidation.com/rpvWebService/RealPhoneValidationActive.php?phone=7275555555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
<RESPONSECODE>L</RESPONSECODE>
<RESPONSEMSG></RESPONSEMSG>
</response>
Example: Inactive Phone Line
https://api.realvalidation.com/rpvWebService/RealPhoneValidationActive.php?phone=7275555555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
<RESPONSECODE>N</RESPONSECODE>
<RESPONSEMSG></RESPONSEMSG>
</response>
Appendix A:
RESPONSECODE | Description |
---|---|
L | Active landline |
C | Active cell phone |
V | Active VoIP (only appears if your account has VoIP determination) |
N | Inactive phone |
unauthorized | Contact support |
HTTP 403 | Temporarily throttled due to exceeding the recommended 10/sec API calls |
Not super techie… integrate RPV Active into your favorite CRM, forms, and apps using Zapier or Integrately.
