Skip to main content
POST
/
v1.5
/
Data
/
RNDBasic
RND Basic (POST)
curl --request POST \
  --url https://dataapi.dncscrub.com/v1.5/Data/RNDBasic \
  --header 'Content-Type: <content-type>' \
  --header 'loginId: <loginid>' \
  --data '
{
  "data": [
    {
      "phoneNumber": "<string>",
      "date": "<string>"
    }
  ],
  "useSandbox": true,
  "ProjId": "<string>"
}
'
[
  {
    "PhoneNumber": "5039367187",
    "IsReassigned": false,
    "HasSafeHarbor": true,
    "IsSandBox": false
  },
  {
    "PhoneNumber": "7075276405",
    "IsReassigned": false,
    "HasSafeHarbor": true,
    "IsSandBox": false
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt

Use this file to discover all available pages before exploring further.

Batch query the FCC Reassigned Number Database (RND) to check if multiple phone numbers have been reassigned after given dates.
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.

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)
​
Content-Type
string
required
Must be application/json

​
Request Body

​
data
array
required
Array of phone number objects to check (maximum 1,000 per request)
​
useSandbox
boolean
(Optional) Set to true to use sandbox mode for testing
​
ProjId
string
Project identifier for tracking purposes

​
Example Request

curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/Data/RNDBasic' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Data": [
      { "phoneNumber": "5039367187", "date": "20211014" },
      { "phoneNumber": "7075276405", "date": "20211122" }
    ]
  }'

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

​
Response Fields

Each object in the response array contains:
​
PhoneNumber
string
The phone number that was checked
​
IsReassigned
boolean | null
Indicates if the phone was reassigned after the consent date:
  • true - Reassigned. Do not call.
  • false - Not reassigned.
  • null - Insufficient FCC data.
​
HasSafeHarbor
boolean
true if an FCC safe harbor exemption may be available
​
IsSandBox
boolean
true if the response was generated in sandbox mode (test data), false for production data.

​
Error Responses

Status CodeDescription
400 Bad RequestThe data property is missing or empty, more than 1,000 phone numbers, or invalid phone number/date format
401 UnauthorizedInvalid or missing API key

​
Batch Processing Example

async function checkRNDBasic(phoneRecords) {
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.5/Data/RNDBasic',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'loginId': 'YOUR_API_KEY'
      },
      body: JSON.stringify({ data: phoneRecords })
    }
  );

  const results = await response.json();

  // Categorize results
  const safeToCall = results.filter(r => r.IsReassigned === false);
  const doNotCall = results.filter(r => r.IsReassigned === true);
  const unknown = results.filter(r => r.IsReassigned === null);

  console.log(`Safe: ${safeToCall.length}`);
  console.log(`Do Not Call: ${doNotCall.length}`);
  console.log(`Unknown (insufficient FCC data): ${unknown.length}`);

  return { safeToCall, doNotCall, unknown };
}

// Usage
const records = [
  { phoneNumber: '5039367187', date: '20211014' },
  { phoneNumber: '7075276405', date: '20211122' }
];

await checkRNDBasic(records);