Skip to main content
GET
/
app
/
main
/
rpc
/
scrub
Scrub Single Number
curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'loginId: <loginid>'
[
  {
    "Phone": "7075276405",
    "ResultCode": "D",
    "Reserved": "",
    "Reason": "National (USA) 2003-06-01;;;",
    "RegionAbbrev": "CA",
    "Country": "US",
    "Locale": "Santa Rosa",
    "CarrierInfo": "9740;RBOC;\"AT&T California:AT&T California\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "0",
    "LineType": "AllOther"
  }
]
Scrub a single phone number against all configured DNC lists and compliance databases.

​
Request

​
Headers

​
loginId
string
required
Your API Key

​
Query Parameters

​
phoneList
string
required
The 10-digit phone number to scrub
​
version
string
default:"5"
required
API version. Use 5
​
output
string
default:"json"
Response format: json or csv
​
projId
string
Optional. Project ID
​
campaignId
string
Optional. Campaign ID

​
Example Request

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/scrub?phoneList=7075276405&version=5&output=json' \
  --header 'loginId: YOUR_API_KEY'

[
  {
    "Phone": "7075276405",
    "ResultCode": "D",
    "Reserved": "",
    "Reason": "National (USA) 2003-06-01;;;",
    "RegionAbbrev": "CA",
    "Country": "US",
    "Locale": "Santa Rosa",
    "CarrierInfo": "9740;RBOC;\"AT&T California:AT&T California\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "0",
    "LineType": "AllOther"
  }
]

​
Response Fields

​
Phone
string
The phone number that was scrubbed
​
ResultCode
string
The scrub result code (see Result Codes)
​
Reserved
string
Reserved field used for unique identifiers
​
Reason
string
Explanation of why the number is flagged
​
RegionAbbrev
string
State/region abbreviation (e.g., “CA”)
​
Country
string
Two-digit country code (e.g., “US”)
​
Locale
string
City or locality
​
CarrierInfo
string
Carrier information in format: ID;TYPE;"Name"
​
TZCode
string
Timezone code
​
UTCOffset
string
UTC offset in minutes
​
IsWirelessOrVoIP
string
1 if wireless/VoIP, 0 otherwise
​
LineType
string
Line type: Wireless, VoIP, or AllOther

​
Handling the Response. Make sure to handle all response codes. The sample below handles just a few

const data = await response.json();
const result = data[0];

switch (result.ResultCode) {
  case "C":
    // Clean - safe to call
    console.log("Phone number is clean");
    break;
  case "D":
    // Do Not Call
    console.log("Do not call:", result.Reason);
    break;
  case "W":
    // Wireless number detected
    console.log("Wireless number detected");
    break;
  default:
    console.log("Result:", result.ResultCode);
}