Scrub API Documentation

The Scrub 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 back in under 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)
*Iscell“Y” means Cell phone, “N” means Landline (“V” is for VoIP if enabled on account)
* CarrierService provider. Such as Verizon, AT&T, etc.

* These fields are optional, and each can be added for an additional charge. If you would like to receive all fields, see RPV Turbo.

For more info, contact support@realvalidation or call 800.777.2770

Example: Connected Phone Line

https://api.realvalidation.com/rpvWebService/RealPhoneValidationScrub.php?phone=7275555555&token=1
234ABCD-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:

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 Scrub into your favorite CRM, forms, and apps using Zapier or Integrately.

Scrub API Doc
Scrub API 060222

Before you go...

Are you currently using a
phone validation service?

Close
Scroll to Top