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’s best in connect/disconnect information in about 2 seconds.

Required Input Parameters:

ParameterDescription
Output(OPTIONAL) set to “json” or “xml”. Omitting this defaults to XML
Phone10 numeric digits ONLY
TokenUnique PW given by RealValidation

Response Fields:

Response FieldDescription
Status(See Appendix A below)
Error_Text(See Appendix A below)
Phone_TypeMobile, Landline, or VoIP
Caller_Name (subscriber name)Name of person associated with phone (if available)
CarrierService 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:

StatusError TextDescription
connectedTypically connected
connected-75Connected 75% of the time
pendingNot completed yet
disconnectedTypically disconnected
disconnected-70Disconnected 70% of the time
busyBusy
unreachableNot reachable
invalid phonePhone not valid
restrictedCan’t be dialed
ERRORbad phone number
ERRORmissing token
unauthorizedtoken is not valid
invalid-formatphone or zip are not in a valid format
invalid-phonephone number is not valid
bad-zip-codezip code is not valid
server-unavailablevarious messagesContact support

Not super techie… integrate Turbo v3 into your favorite CRM, forms, and apps using Zapier or Integrately.

Turbo v3 API Doc
Turbo v3 API 060222

Before you go...

Are you currently using a
phone validation service?

Close
Scroll to Top