Skip to main content
POST
https://dataapi.dncscrub.com
/
v1.5
/
Scrub
/
litigator
Litigator Scrub Multiple Numbers
curl --request POST \
  --url https://dataapi.dncscrub.com/v1.5/Scrub/litigator \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "PhoneList": "<string>",
  "CampaignId": 123,
  "ProjId": "<string>",
  "OutputFormat": "<string>"
}
'
[
  {
    "Phone": 2675466417,
    "IsLitigator": true
  },
  {
    "Phone": 5039367187,
    "IsLitigator": true
  },
  {
    "Phone": 7075276405,
    "IsLitigator": false
  }
]
Check a list of phone numbers against the litigator database using an HTTP POST request. Use this method for large batches (over 50 phone numbers, up to 10,000).

​
Request

​
Headers

​
loginId
string
API Key
​
Content-Type
string
required
Must be application/json

​
Request Body

​
PhoneList
string
required
Comma-separated list of 10-digit phone numbers to check (up to 10,000 numbers)
​
CampaignId
integer
Optional campaign ID for tracking purposes
​
ProjId
string
Optional project ID for tracking and settings purposes
​
OutputFormat
string
default:"JsonArray"
Optional Output format: JsonArray (default) or JsonObject. By default returns JsonArray.

​
Example Request

curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/Scrub/litigator' \
  --header 'Content-Type: application/json' \
  --header 'loginId: YOUR_API_KEY' \
  --data-raw '{
    "PhoneList": "2675466417,5039367187,7075276405"
  }'

[
  {
    "Phone": 2675466417,
    "IsLitigator": true
  },
  {
    "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, malformed JSON, or missing required parameters
​
401 Unauthorized
Invalid or missing API key
​
404 Not Found
Endpoint not found or invalid URL

​
Batch Processing Example

When processing large lists, you may want to batch and process results: 
async function checkLitigators(phoneNumbers) {
  // Join phone numbers into comma-separated string
  const phoneList = phoneNumbers.join(",");

  const response = await fetch(
    "https://dataapi.dncscrub.com/v1.5/Scrub/litigator",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        loginId: "YOUR_API_KEY",
      },
      body: JSON.stringify({ PhoneList: phoneList }),
    }
  );

  const results = await response.json();

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

  return {
    litigators: litigators.map((r) => r.Phone),
    safe: safe.map((r) => r.Phone),
    totalChecked: results.length,
  };
}

// Usage
const phones = ["2675466417", "5039367187", "7075276405"];
const result = await checkLitigators(phones);
console.log(`Found ${result.litigators.length} litigators`);

​
Security Best Practice

For additional security, pass the loginId in the HTTP header rather than in the JSON body. This prevents your API key from appearing in application logs.