Turbo v3 API Documentation

The RealPhoneValidation Turbo API uses GET/POST methods and supports only HTTPS with TLS v1.2+. Determines connectivity in a flash and you get the industry best in connect/disconnect information in about 2 seconds.
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)
Phone_Type
Mobile, Landline, or VoIP
Caller_Name (subscriber name)
Name of person associated with phone (if available)
Carrier
Service provider. Such as Verizon, AT&T, etc.
Caller_Type (subscriber type)
Consumer, Business, or Unavailable
Example: Connected Phone Line
https://api.realvalidation.com/rpvWebService/TurboV3.php?output=xml&phone=7275555555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF
Result in XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <status>connected</status>
   <error_text></error_text>
   <phone_type>Mobile</phone_type>
   <caller_name>Jack Smith</caller_name>
   <carrier>Verizon Wireless:6006 - SVR/2</carrier>
   <caller_type>Consumer</caller_type>
</response>
Result in JSON
{
"status":"connected",
"error_text":{},
"phone_type":"Mobile",
"caller_name":"Jack Smith",
"carrier":"Verizon Wireless:6006 - SVR\/2"
"caller_type":"Consumer",
}
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 Turbo v3 into your favorite CRM, forms, and apps using Zapier or Integrately.

Turbo v3 API Doc
Turbo v3 060222