RPV US Premium API Documentation

The RealPhoneValidation US Premium API uses GET/POST methods and supports only HTTPS with TLS v1.2+

Required Input Parameters:
Parameter
Description
Output
(OPTIONAL) set to “json” or “xml”. Omitting this defaults to XML
Phone
10 numeric digits ONLY
Token
unique PW given by RealValidation
Response Fields:
Response Field
Description
Status
(See appendix A below)
Error_text
(See appendix A below)
Iscell
“Y” means Cell phone, “N” means Landline (“V” is for VoIP if enabled on account)
Carrier
Service provider. Such as Verizon, AT&T, etc.
Example: Connected Phone Line
https://api.realvalidation.com/rpvWebService/RealPhoneValidationUSPrem.php?output=xml&phone=7275555
555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <status>connected</status>
   <error_text></error_text>
   <iscell>Y</iscell>
   <carrier>Verizon Wireless:6006 - SVR/2</carrier>
</response>
Result in JSON
{
"status":"connected",
"error_text":{},
"iscell":"Y",
"carrier":"Verizon Wireless:6006 - SVR\/2"
}
Appendix A:
Status
Error Text
Description
connected

Typically connected
connected-75

Connected 75% of the time
pending

Not completed yet
disconnected

Typically disconnected
disconnected-70

Disconnected 70% of the time
busy

Busy
unreachable

Not reachable
invalid phone

Phone not valid
restricted

Can’t be dialed
ERROR
bad phone number

ERROR
missing token

unauthorized
token is not valid

invalid-format
phone or zip are not in a valid format

invalid-phone
phone number is not valid

bad-zip-code
zip code is not valid

server-unavailable
various messages
Contact support

Not super techie... integrate RPV US Premium API into your favorite CRM, forms, and apps using Zapier or Integrately.

RPV US Premium API Doc
RPV US Premium 060222