Litigator Scrub Multiple Numbers

Check phone numbers against the litigator database using POST request

POST /v1.5/Scrub/litigator

Litigator Scrub Multiple Numbers

cURL

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>"
}
'

Response

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

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"
  }'

Response

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

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