Litigator Scrub Single Number

Check phone numbers against the litigator database using GET request

GET /v1.5/Scrub/litigator

Litigator Scrub Single Number

cURL

curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Scrub/litigator \
  --header 'loginId: <loginid>'

Response

[
  {
    "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

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

Response

[
  {
    "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

Status	Description
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.