Skip to main content

​
RND Basic API

The RND (Reassigned Number Database) Basic API provides a streamlined interface for checking if phone numbers have been reassigned using the FCC Reassigned Number Database.

​
Endpoint

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

​
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)
projIdNoProject identifier for tracking purposes

​
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/RNDBasic?phoneNumber=7075276405&date=20211109' \
  --header 'loginId: YOUR_API_KEY'

​
Response

{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "HasSafeHarbor": true,
  "IsSandBox": 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/RNDBasic' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Data": [
      { "phoneNumber": "7075276405", "date": "20211109" },
      { "phoneNumber": "5039367187", "date": "20211109" }
    ],
    "UseSandbox": false,
    "ProjId": "Demo"
  }'

​
Response

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

​
Response Fields

FieldTypeDescription
PhoneNumberStringThe phone number checked
IsReassignedBoolean/nulltrue = reassigned, false = not reassigned, null = unknown
HasSafeHarborBooleantrue if FCC safe harbor exemption may be available
IsSandBoxBooleantrue if response was generated in sandbox mode, false for production data

​
Rate Limits

LimitValue
Numbers per request1,000

​
Use Cases

  • Basic reassignment detection
  • Cost-effective compliance checking
  • Safe harbor verification

​
Getting Started

Contact our support team to:
  1. Get your API credentials
  2. Access Postman collection samples

Reassigned Authority Plus API

Enhanced reassigned number API with carrier data and extended historical coverage

Test Numbers

Test phone numbers for development