Scrub Multiple Numbers

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'Content-Type: application/json' \
  --header 'loginId: <loginid>' \
  --data '
{
  "phoneList": "<string>",
  "version": "<string>",
  "output": "<string>",
  "projId": "<string>",
  "campaignId": "<string>"
}
'

import requests

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

payload = {
    "phoneList": "<string>",
    "version": "<string>",
    "output": "<string>",
    "projId": "<string>",
    "campaignId": "<string>"
}
headers = {
    "loginId": "<loginid>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {loginId: '<loginid>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phoneList: '<string>',
    version: '<string>',
    output: '<string>',
    projId: '<string>',
    campaignId: '<string>'
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phoneList' => '<string>',
    'version' => '<string>',
    'output' => '<string>',
    'projId' => '<string>',
    'campaignId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("loginId", "<loginid>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.dncscrub.com/app/main/rpc/scrub")
  .header("loginId", "<loginid>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}")
  .asString();

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::Post.new(url)
request["loginId"] = '<loginid>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}"

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

[
  {
    "Phone": "5039367187",
    "ResultCode": "D",
    "Reserved": "",
    "Reason": "Litigator",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  },
  {
    "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"
  }
]

POST

app

main

rpc

scrub

Scrub Multiple Numbers

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'Content-Type: application/json' \
  --header 'loginId: <loginid>' \
  --data '
{
  "phoneList": "<string>",
  "version": "<string>",
  "output": "<string>",
  "projId": "<string>",
  "campaignId": "<string>"
}
'

import requests

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

payload = {
    "phoneList": "<string>",
    "version": "<string>",
    "output": "<string>",
    "projId": "<string>",
    "campaignId": "<string>"
}
headers = {
    "loginId": "<loginid>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {loginId: '<loginid>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phoneList: '<string>',
    version: '<string>',
    output: '<string>',
    projId: '<string>',
    campaignId: '<string>'
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phoneList' => '<string>',
    'version' => '<string>',
    'output' => '<string>',
    'projId' => '<string>',
    'campaignId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("loginId", "<loginid>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.dncscrub.com/app/main/rpc/scrub")
  .header("loginId", "<loginid>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}")
  .asString();

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::Post.new(url)
request["loginId"] = '<loginid>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\"\n}"

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

[
  {
    "Phone": "5039367187",
    "ResultCode": "D",
    "Reserved": "",
    "Reason": "Litigator",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  },
  {
    "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"
  }
]

Submit multiple phone numbers in a single request for efficient batch processing.

To add or refresh EBR records in the same call as a scrub, use Scrub + Add EBR.

If you scrub more than 10 phone numbers, use HTTP POST instead of HTTP GET. If you do not know your batch size, safest option is always use HTTP POST. The maximum number of records that can be scrubbed per requests is 10,000. If you have larger batches, consider using SFTP.

Request

Headers

Your API Key

Request Body

string

required

Comma-separated list of 10-digit phone numbers (e.g., 5039367187,7075276405,7072842774). To include a system identifier with each result, append |{id} to the phone number (e.g., 5039367187|abc-10232,7075276405|abc-10233,7072842774|abc-10234).

string

default:"5"

required

API version. Use 5

string

default:"json"

Response format: json or csv

string

Optional. Project ID

string

Optional. Campaign ID

Example Request

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/scrub' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "phoneList": "5039367187,7075276405,7072842774",
    "version": "5",
    "output": "json"
  }'

const phoneNumbers = ["5039367187", "7075276405", "7072842774"];
const phoneList = phoneNumbers.join(",");

const response = await fetch("https://www.dncscrub.com/app/main/rpc/scrub", {
  method: "POST",
  headers: {
    loginId: "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phoneList: phoneList,
    version: "5",
    output: "json",
  }),
});

const results = await response.json();
results.forEach((result) => {
  console.log(`${result.Phone}: ${result.ResultCode}`);
});

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

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

    var requestBody = new
    {
        phoneList = "5039367187,7075276405,7072842774",
        version = "5",
        output = "json"
    };

    var json = System.Text.Json.JsonSerializer.Serialize(requestBody);
    var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json");

    var response = await client.PostAsync(
        "https://www.dncscrub.com/app/main/rpc/scrub",
        content
    );
    var responseString = await response.Content.ReadAsStringAsync();
}

[
  {
    "Phone": "5039367187",
    "ResultCode": "D",
    "Reserved": "",
    "Reason": "Litigator",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "5820;WIRELESS;\"Verizon Wireless:Verizon Wireless\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "",
    "IsWirelessOrVoIP": "1",
    "LineType": "Wireless"
  },
  {
    "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

string

The phone number that was scrubbed

string

The scrub result code (see Result Codes)

string

Reserved field (used for unique identifiers)

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

Processing Multiple Results

const results = await response.json();

const clean = results.filter((r) => r.ResultCode === "C");
const doNotCall = results.filter((r) => r.ResultCode === "D");
const wireless = results.filter((r) => r.IsWirelessOrVoIP === "1");

console.log(`Clean numbers: ${clean.length}`);
console.log(`Do Not Call: ${doNotCall.length}`);
console.log(`Wireless: ${wireless.length}`);

Using HTTP POST for Large Batches

For more than 10 phone numbers, use HTTP POST with a JSON body:

using (var client = new HttpClient())
{
    System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

    var requestBody = new
    {
        phoneList = "5039367187,7075276405,...",
        version = "5",
        output = "csv"  // Recommended for large batches
    };

    var json = System.Text.Json.JsonSerializer.Serialize(requestBody);
    var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json");

    var response = await client.PostAsync(
        "https://www.dncscrub.com/app/main/rpc/scrub",
        content
    );
    var responseString = await response.Content.ReadAsStringAsync();
}

Best Practices

Batch Size

While the API can handle large batches, consider breaking very large lists into batches of 1,000-5,000 numbers for optimal performance.

Output Format

Use output=csv for large batches. CSV parsing is more efficient for high-volume processing.

Error Handling

Operations are atomic. If one phone number is invalid, the entire batch fails. Validate phone numbers before sending.

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Scrub Multiple Numbers

Request

Headers

Request Body

Example Request

Response Fields

Processing Multiple Results

Using HTTP POST for Large Batches

Best Practices

​Request

​Headers

​Request Body

​Example Request

​Response Fields

​Processing Multiple Results

​Using HTTP POST for Large Batches

​Best Practices

Request

Headers

Request Body

Example Request

Response Fields

Processing Multiple Results

Using HTTP POST for Large Batches

Best Practices