Skip to main content
GET
https://dataapi.dncscrub.com
/
v1.5
/
Scrub
/
litigator
Litigator Scrub Single Number
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Scrub/litigator \
  --header 'loginId: <loginid>'
[
  {
    "Phone": 5039367187,
    "IsLitigator": true
  },
  {
    "Phone": 7075276405,
    "IsLitigator": false
  }
]
Check a list of phone numbers against the litigator database using an HTTP GET request. Use this method for small batches (up to 100 phone numbers).
For batches larger than 100 phone numbers, use the POST method instead.

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)

​
Query Parameters

​
phoneList
string
required
Comma-separated list of 10-digit phone numbers to check (maximum 100 numbers for GET requests, up to 10,000 for POST)
​
campaignId
integer
Optional campaign ID for tracking purposes
​
projId
string
Optional project ID for tracking purposes
​
outputFormat
string
default:"JsonArray"
Output format: JsonArray (default) or JsonObject for Zapier compatibility

​
Example Request

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405' \
  --header 'loginId: YOUR_API_KEY'

[
  {
    "Phone": 5039367187,
    "IsLitigator": true
  },
  {
    "Phone": 7075276405,
    "IsLitigator": false
  }
]

​
Response Fields

​
Phone
integer
The 10-digit phone number that was checked
​
IsLitigator
boolean
true if the phone number is associated with a known TCPA litigator, false otherwise

​
Error Responses

​
400 Bad Request
Invalid phone number format or missing required parameters
​
401 Unauthorized
Invalid or missing API key
​
404 Not Found
Endpoint not found or invalid URL

​
Processing the Response

const results = await response.json();

// Filter litigator numbers
const litigators = results.filter((r) => r.IsLitigator);
const safe = results.filter((r) => !r.IsLitigator);

console.log(`Litigators found: ${litigators.length}`);
console.log(`Safe numbers: ${safe.length}`);

// Flag litigator numbers
litigators.forEach((r) => {
  console.log(`WARNING: ${r.Phone} is a known litigator`);
});

​
Security Best Practice

For additional security, pass the loginId in the HTTP header rather than as a query parameter. This prevents your API key from appearing in server logs and browser history.