Skip to main content

​
Reassigned Authority + Litigator API

The Reassigned Authority + Litigator API combines reassignment checking with litigator database lookup in a single API call. This provides comprehensive risk assessment by checking both if a phone number has been reassigned and whether the owner is a known TCPA litigator.

​
Endpoint

https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthorityLitigator

​
Authentication

Include your API key in the loginId HTTP header: 
--header 'loginId: YOUR_API_KEY'

​
Parameters

ParameterRequiredDescription
phoneNumberYes10-digit phone number (no leading 1 or +)
dateYesConsent date to check against
useSandboxNoSet to true to use sandbox mode for testing (returns random results)

​
Date Formats

The date parameter accepts multiple formats:
FormatExample
MM/DD/YYYY09/29/2021
YYYY-MM-DD2021-09-29
MM/DD/YY09/29/21
YYYYMMDD20210929

​
Single Number Request (GET)

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

​
Response

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

​
Multiple Number Request (POST)

For checking multiple numbers, use HTTP POST with a JSON body: 
curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthorityLitigator' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Data": [
      { "PhoneNumber": "7075276405", "Date": "20210209" },
      { "PhoneNumber": "5039367187", "Date": "20210209" }
    ]
  }'

​
Response

[
  {
    "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
  },
  {
    "PhoneNumber": "5039367187",
    "IsReassigned": false,
    "IsValid": true,
    "LineType": "Wireless",
    "Carrier": "Verizon Wireless",
    "Locale": "Portland",
    "Region": "OR",
    "Country": "US",
    "TZ": "America/Los_Angeles",
    "UTCOffset": "-420",
    "IsLitigator": true
  }
]

​
Response Fields

FieldTypeDescription
PhoneNumberStringThe phone number checked
IsReassignedBoolean/nulltrue = reassigned, false = not reassigned, null = insufficient data
IsValidBooleantrue if the number is callable, false if invalid
LineTypeStringWireless, VoIP, Landline, Paging, or Unknown
CarrierStringOriginal carrier the number was assigned to
LocaleStringCity based on original assignment
RegionStringState/region based on original assignment
CountryStringTwo-digit ISO country code
TZStringTimezone in IANA format (e.g., America/Los_Angeles)
UTCOffsetStringUTC offset in minutes
IsLitigatorBooleantrue if the phone number is associated with a known TCPA litigator

​
Risk Assessment

The phone number was reassigned to a new person after the consent date you provided.Action: Do not call this number. Your consent is no longer valid.
The phone number is associated with a known TCPA litigator.Action: Exercise extreme caution. Consider not calling this number.
The number has not been reassigned and is not associated with a known litigator.Action: Safe to call - proceed with your campaign.

​
Rate Limits

LimitValue
Numbers per request1,000

​
Decision Logic Example

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");
}