is_litigator Tool - Contact Center Compliance

The is_litigator tool checks if one or more phone numbers are associated with individuals who have filed TCPA (Telephone Consumer Protection Act) or related consumer-protection lawsuits.

Parameters

string[]

required

Phone numbers in 10-digit North American format (e.g., "8663625478").

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

number

Campaign ID in DNCScrub for usage tracking and sensitivity configuration.

string

Project ID in DNCScrub for usage tracking and sensitivity configuration.

Response

boolean

Whether the API call succeeded.

array

Array of phone check results (when successful).

Show results object

string

The phone number that was checked.

boolean

true if the number belongs to a known litigator.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Error Codes

Code	Description
`MISSING_API_KEY`	No API key provided in header or parameter
`INVALID_API_KEY`	The API key is invalid or unauthorized
`API_ERROR`	DNCScrub API returned an error
`MISSING_INPUT`	Required parameters are missing

Examples

Request
Success Response
Error Response

{
  "phoneNumbers": ["8663625478", "5551234567"]
}

{
  "success": true,
  "results": [
    { "phone": "8663625478", "isLitigator": false },
    { "phone": "5551234567", "isLitigator": true }
  ]
}

{
  "success": false,
  "errorCode": "INVALID_API_KEY",
  "errorMessage": "The provided API key is invalid or unauthorized"
}

Usage Notes

Check multiple numbers in a single request for better performance
Results are returned in the same order as the input array
Phone numbers should be 10 digits without formatting (no dashes, spaces, or country code)

​Parameters

​Response

​Error Codes

​Examples

​Usage Notes

Parameters

Response

Error Codes

Examples

Usage Notes