Full Scrub API Overview

The Full Scrub API allows you to check phone numbers against multiple compliance databases including:

National DNC Registry (USA and Canada)
State DNC Lists
Your Internal DNC (IDNC) Database
Litigator Lists
Consent and EBR (Existing Business Relationship) Records
Wireless Number Identification
VoIP Identification
Calling Time Restrictions
Holiday Restrictions
Consent (express written consent) for autodialed and AI-voice calls

The Full Scrub API is only checking for DNC status and Calling TIme\Holiday restrictions. For full TCPA compliance, you also need to scrub for Reassigned Numbers. A second API call is needed to scrub for Reassigned Scrubbing such as Reassigned Authority Plus.

Base URL

https://www.dncscrub.com/app/main/rpc/scrub

Quick Start

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

const response = await fetch(
  "https://www.dncscrub.com/app/main/rpc/scrub?phoneList=7075276405&version=8&output=json",
  {
    method: "GET",
    headers: { loginId: "YOUR_API_KEY" },
  }
);
const data = await response.json();

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");
    var response = await client.GetStringAsync(
        "https://www.dncscrub.com/app/main/rpc/scrub?phoneList=7075276405&version=8&output=json"
    );
}

Parameters

Parameter	Required	Description
`phoneList`	Yes	Phone number(s) to scrub. Comma-separated for multiple. Each may carry `\|ID` or `\|ID\|POSTALCODE` suffixes; the postal code makes time zone and calling window follow the contact’s location (see Postal Code Time Zones)
`version`	Yes	API output version. Use `8` for current version.
`output`	No	Response format: `json` or `csv` (default)
`projId`	No	Project ID for specific project
`campaignId`	No	Campaign ID for specific campaign

Response Example

[
  {
    "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",
    "EBRExpiresOn": "",
    "WirelessPortDate": "0",
    "VoIPDate": "",
    "PostalCode": "",
    "TZSource": "areaCode",
    "IsCallAllowedNonATDS": "0",
    "IsCallAllowedATDS": "0",
    "IsCallAllowedAI": "0"
  }
]

Result Codes

The ResultCode field indicates the scrub result:

Code	Meaning	Action
`C`	Clean	Phone number is safe to call
`D`	Do Not Call	Phone number is on a DNC list
`W`	Wireless	Wireless number, not in DNC, not blocked
`L`	Wireless Prohibited	Wireless in a state prohibiting solicitation
`G`	EBR + Wireless	Valid EBR and wireless, not on any DNC
`H`	EBR Override + Wireless	Wireless with valid EBR overriding DNC
`F`	Wireless Restricted	Wireless in state not allowing even manual dialing

For a complete list of result codes and field descriptions, see the Output Guide.

Available Endpoints

Scrub Single Number

Scrub a single phone number

Scrub Multiple Numbers

Scrub multiple phone numbers in one request

Unique Identifier

Pass a unique ID with each phone number

Internal DNC

Add or remove numbers from your Internal DNC

EBR List

Manage Existing Business Relationship records

AI Voice Agents

One flag that tells an AI dialer whether it may place the call

Output Guide

Complete field reference

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Base URL

Quick Start

Parameters

Response Example

Result Codes

Available Endpoints

Scrub Single Number

Scrub Multiple Numbers

Unique Identifier

Internal DNC

EBR List

AI Voice Agents

Output Guide

​Base URL

​Quick Start

​Parameters

​Response Example

​Result Codes

​Available Endpoints

Scrub Single Number

Scrub Multiple Numbers

Unique Identifier

Internal DNC

EBR List

AI Voice Agents

Output Guide

Base URL

Quick Start

Parameters

Response Example

Result Codes

Available Endpoints