Skip to main content
GET
/
v1.5
/
Data
/
TCPAAuthorityLitigator
TCPA Authority + Litigator (GET)
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthorityLitigator \
  --header 'loginId: <loginid>'
{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "IsValid": true,
  "LineType": "Landline",
  "Carrier": "AT&T California",
  "Locale": "Santa Rosa",
  "Region": "CA",
  "Country": "US",
  "TZ": "America/Los_Angeles",
  "UTCOffset": "-420",
  "IsLitigator": false
}
Check if a phone number has been reassigned and whether the owner is a known TCPA litigator in a single API call. This combines the functionality of TCPA Authority with litigator checking.
This endpoint provides comprehensive risk assessment by checking both reassignment status and litigator database in one request.

​
Request

​
Headers

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

​
Query Parameters

​
phoneNumber
string
required
10-digit North American phone number (without leading 1 or +)
​
date
string
required
Consent date to check reassignment against. Supported formats: MM/DD/YYYY, YYYY-MM-DD, MM/DD/YY, or YYYYMMDD
​
useSandbox
boolean
default:"false"
Set to true to use sandbox mode for testing (returns random results)

​
Example Request

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthorityLitigator?phoneNumber=7075276405&date=20210209' \
  --header 'loginId: YOUR_API_KEY'

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "IsValid": true,
  "LineType": "Landline",
  "Carrier": "AT&T California",
  "Locale": "Santa Rosa",
  "Region": "CA",
  "Country": "US",
  "TZ": "America/Los_Angeles",
  "UTCOffset": "-420",
  "IsLitigator": false
}

​
Response Fields

​
PhoneNumber
string
The phone number that was checked
​
IsReassigned
boolean | null
Indicates if the phone was reassigned after the consent date:
  • true - Reassigned after the date. Do not call.
  • false - Not reassigned.
  • null - Insufficient information to determine reassignment status.
​
IsValid
boolean
true if the phone number is valid and callable, false if not valid
​
LineType
string
Type of phone line: Wireless, VoIP, Landline, Paging, or Unknown
​
Carrier
string
Original carrier the phone number was assigned to
​
Locale
string
City based on original phone number assignment
​
Region
string
State/region based on original phone number assignment
​
Country
string
Two-digit ISO country code
​
TZ
string
Timezone in ISO IANA format (e.g., America/Los_Angeles)
​
UTCOffset
string
UTC offset in minutes
​
IsLitigator
boolean
true if the phone number is associated with a known TCPA litigator, false otherwise

​
Error Responses

StatusDescription
400 Bad RequestInvalid phone number format, invalid date format, or missing required parameters
401 UnauthorizedInvalid or missing API key
403 ForbiddenAccount not authorized for this API or insufficient credits

​
Decision Logic

const result = await response.json();

// Check all risk factors
const risks = [];

if (result.IsReassigned === true) {
  risks.push('Number has been reassigned');
}

if (result.IsLitigator === true) {
  risks.push('Number belongs to known litigator');
}

if (!result.IsValid) {
  risks.push('Number is not valid');
}

if (risks.length > 0) {
  console.log('DO NOT CALL - Risks:', risks.join(', '));
} else {
  console.log('Safe to call');
}