DNC Litigator API Documentation

DNC Litigator API uses GET/POST methods and supports only HTTPS with TLS v1.2+. Determines if the phone number is associated with a known TCPA litigator or serial plaintiff.

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
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
Phone	10 numeric digits ONLY
RESPONSECODE	“OK” or corresponding error code – see appendix A
RESPONSEMSG	Blank or corresponding error message – see Appendix A
litigator	“Y” = on the known litigator list, “N” = not on the list, “?” = on a Do-Not-Call list or timeout
ID	Internal identifier

Example API Call

https://api.realvalidation.com/rpvWebService/DNCLitLookup.php?phone=7275555555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF

Result in XML

<?xml version= "1.0 " encoding= "UTF-8 "?>
<response>
 <RESPONSECODE>OK</RESPONSECODE>
 <RESPONSEMSG></RESPONSEMSG>
 <litigator>N</litigator>
 <id>4</id>
<response>

Result in JSON

{
"RESPONSECODE":"OK",
"RESPONSEMSG":{},
"litigator":"N",
"id":"4"
}

Appendix A:

Status	Error Text	Description
-1	Missing number	Missing or badly formatted number
102	The user is invalid	The phone number does not exist
unauthorized	< blank >	incorrect token or suspended account
invalid-phone	Phone number does not exist
HTTP 403		Temporarily throttled due to exceeding the recommended 10/sec API calls

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

DNC Litigator API Documentation

DNC Litigator API 07122025