Skip to main content
GET
/
v1.5
/
Data
/
RNDBasic
RND Basic (GET)
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/Data/RNDBasic \
  --header 'loginId: <loginid>'
{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "HasSafeHarbor": true,
  "IsSandBox": false
}
Query the FCC Reassigned Number Database (RND) to check if a phone number has been reassigned after a given date.
The FCC Reassigned Number Database only has complete data after January 27, 2021. Numbers with consent dates prior to this date will typically return a blank IsReassigned value indicating insufficient data.

​
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"
(Optional) Set to true to use sandbox mode for testing (returns random results)
​
projId
string
Project identifier for tracking purposes

​
Example Request

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

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "HasSafeHarbor": true,
  "IsSandBox": false
}

​
Response Fields

​
PhoneNumber
string
The phone number that was checked
​
IsReassigned
boolean | null
Indicates if the phone was reassigned after the consent date based on FCC data: - true (or 1) - Reassigned after the date. Do not call. - false (or 0) - Not reassigned. - null (blank) - Insufficient data in the FCC database to determine.
​
HasSafeHarbor
boolean
true if an FCC safe harbor exemption may be available for this number
​
IsSandBox
boolean
true if the response was generated in sandbox mode (test data), false for production data.

​
Error Responses

Status CodeDescription
400 Bad RequestInvalid phone number format, invalid date format, or missing required parameters
401 UnauthorizedInvalid or missing API key

​
Processing the Response

const result = await response.json();

if (result.IsReassigned === true) {
  console.log("DO NOT CALL - Number has been reassigned per FCC data");
} else if (result.IsReassigned === false) {
  console.log("Safe to call - Number has not been reassigned");
  if (result.HasSafeHarbor) {
    console.log("FCC Safe Harbor exemption may be available");
  }
} else {
  console.log(
    "Insufficient FCC data - consider using TCPA Authority for older consent dates"
  );
}

​
When to Use RND Basic vs TCPA Authority

FeatureRND BasicTCPA Authority
Data SourceFCC Reassigned Number Database onlyCarrier data + FCC data
Data CoverageJanuary 27, 2021 onwardsJuly 2018 onwards
Update FrequencyMonthlyDaily
Additional DataSafe harbor onlyLine type, carrier, location, timezone
CostLowerHigher
For comprehensive coverage, especially with older consent dates, consider using TCPA Authority instead.