Scrub with Unique Identifiers

curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'loginId: <loginid>'

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://www.dncscrub.com/app/main/rpc/scrub', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.dncscrub.com/app/main/rpc/scrub",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.dncscrub.com/app/main/rpc/scrub"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.dncscrub.com/app/main/rpc/scrub")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

[
  {
    "Phone": "5039367181",
    "ResultCode": "W",
    "Reserved": "ACCT-12345",
    "Reason": ";;;W",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "8:00-21:00;8:00-21:00;8:00-21:00",
    "UTCOffset": "-420",
    "DoNotCallToday": "0",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  }
]

GET

app

main

rpc

scrub

Scrub with Unique Identifiers

curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'loginId: <loginid>'

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://www.dncscrub.com/app/main/rpc/scrub', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.dncscrub.com/app/main/rpc/scrub",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.dncscrub.com/app/main/rpc/scrub"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.dncscrub.com/app/main/rpc/scrub")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

[
  {
    "Phone": "5039367181",
    "ResultCode": "W",
    "Reserved": "ACCT-12345",
    "Reason": ";;;W",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "8:00-21:00;8:00-21:00;8:00-21:00",
    "UTCOffset": "-420",
    "DoNotCallToday": "0",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  }
]

Pass a unique identifier (such as Account ID, Record ID, or Member ID) with each phone number and have it returned in the response. This allows you to easily match scrub results back to your records.

How It Works

Append a pipe character (|) followed by your unique identifier to each phone number:

phoneList=5039367181|UniqueID

The unique identifier will be returned in the Reserved field of the response.

Request

Headers

Your API Key

Query Parameters

string

required

Phone number with identifier in format: PHONE|ID (e.g., 5039367181|ACCT-12345). For multiple numbers, comma-separate them: 5039367181|ACCT-001,7075276405|ACCT-002

string

default:"5"

required

API version. Use 5

string

default:"csv"

Response format: json or csv

string

Project ID

string

Campaign ID

Example Request

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

const phoneNumber = "5039367181";
const accountId = "ACCT-12345";

const response = await fetch(
  `https://www.dncscrub.com/app/main/rpc/scrub?phoneList=${phoneNumber}|${accountId}&version=5&output=json`,
  {
    method: "GET",
    headers: { loginId: "YOUR_API_KEY" },
  }
);

const data = await response.json();
console.log("Account ID:", data[0].Reserved); // "ACCT-12345"

System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

    var phoneNumber = "5039367181";
    var accountId = "ACCT-12345";
    var url = $"https://www.dncscrub.com/app/main/rpc/scrub?phoneList={phoneNumber}|{accountId}&version=5&output=json";

    var response = await client.GetStringAsync(url);
    Console.WriteLine(response);
}

[
  {
    "Phone": "5039367181",
    "ResultCode": "W",
    "Reserved": "ACCT-12345",
    "Reason": ";;;W",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "8:00-21:00;8:00-21:00;8:00-21:00",
    "UTCOffset": "-420",
    "DoNotCallToday": "0",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  }
]

The Reserved field contains your unique identifier "ACCT-12345".

Response Fields

string

The phone number that was scrubbed

string

The scrub result code (see Result Codes)

string

Your unique identifier passed with the phone number

string

Explanation of why the number is flagged

string

State/region abbreviation (e.g., “CA”)

string

Country code (e.g., “US”)

string

City or locality

string

Carrier information in format: ID;TYPE;"Name"

string

Timezone code

string

UTC offset in minutes

string

1 if wireless/VoIP, 0 otherwise

string

Line type: Wireless, VoIP, or AllOther

Multiple Numbers with Identifiers

Comma-separate multiple phone numbers with their identifiers:

phoneList=5039367181|ACCT-001,7075276405|ACCT-002,7072842774|ACCT-003

Example

const records = [
  { phone: "5039367181", accountId: "ACCT-001" },
  { phone: "7075276405", accountId: "ACCT-002" },
  { phone: "7072842774", accountId: "ACCT-003" },
];

const phoneList = records.map((r) => `${r.phone}|${r.accountId}`).join(",");

// phoneList = "5039367181|ACCT-001,7075276405|ACCT-002,7072842774|ACCT-003"

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

const results = await response.json();

// Match results back to original records
results.forEach((result) => {
  console.log(`Account ${result.Reserved}: ${result.ResultCode}`);
});

Use Cases

CRM Integration

Pass your CRM Record ID to update records directly after scrubbing

Batch Processing

Track which phone number belongs to which customer in large batches

Audit Trail

Include transaction IDs for compliance logging

Database Updates

Pass primary keys to enable efficient database updates

Best Practices

The unique identifier should not contain commas (,) or pipe characters (|) as these are used as delimiters.

Keep identifiers reasonably short
Use URL-safe characters
Consider encoding special characters if needed

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Scrub with Unique Identifiers

How It Works

Request

Headers

Query Parameters

Example Request

Response Fields

Multiple Numbers with Identifiers

Example

Use Cases

CRM Integration

Batch Processing

Audit Trail

Database Updates

Best Practices

​How It Works

​Request

​Headers

​Query Parameters

​Example Request

​Response Fields

​Multiple Numbers with Identifiers

​Example

​Use Cases

CRM Integration

Batch Processing

Audit Trail

Database Updates

​Best Practices

How It Works

Request

Headers

Query Parameters

Example Request

Response Fields

Multiple Numbers with Identifiers

Example

Use Cases

Best Practices