RND Basic (POST)

Batch query the FCC Reassigned Number Database

POST /v1.5/Data/RNDBasic

RND Basic (POST)

cURL

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

Response

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

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)

Show data object properties

phoneNumber · string · required

10-digit North American phone number (without leading 1 or +)

date · string · required

Consent date in format YYYYMMDD, MM/DD/YYYY, YYYY-MM-DD, or MM/DD/YY

useSandbox · boolean

(Optional) Set to true to use sandbox mode for testing

ProjId · string

Project identifier for tracking purposes

Example Request

cURL

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" }
    ]
  }'

Response

[
  {
    "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 Code	Description
400 Bad Request	The data property is missing or empty, more than 1,000 phone numbers, or invalid phone number/date format
401 Unauthorized	Invalid 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);