Scrub + Add EBR

Scrub + Add EBR

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'Content-Type: <content-type>' \
  --header 'loginId: <loginid>' \
  --data '
{
  "phoneList": "<string>",
  "version": "<string>",
  "output": "<string>",
  "projId": "<string>",
  "campaignId": "<string>",
  "keepBetterEBR": 123,
  "ebrList": [
    {
      "phoneNumber": "<string>",
      "type": "<string>",
      "dateOfLastContact": "<string>",
      "dateObligationEnds": "<string>",
      "referenceNum": "<string>",
      "brand": "<string>",
      "email": "<string>"
    }
  ]
}
'

import requests

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

payload = {
    "phoneList": "<string>",
    "version": "<string>",
    "output": "<string>",
    "projId": "<string>",
    "campaignId": "<string>",
    "keepBetterEBR": 123,
    "ebrList": [
        {
            "phoneNumber": "<string>",
            "type": "<string>",
            "dateOfLastContact": "<string>",
            "dateObligationEnds": "<string>",
            "referenceNum": "<string>",
            "brand": "<string>",
            "email": "<string>"
        }
    ]
}
headers = {
    "loginId": "<loginid>",
    "Content-Type": "<content-type>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {loginId: '<loginid>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    phoneList: '<string>',
    version: '<string>',
    output: '<string>',
    projId: '<string>',
    campaignId: '<string>',
    keepBetterEBR: 123,
    ebrList: [
      {
        phoneNumber: '<string>',
        type: '<string>',
        dateOfLastContact: '<string>',
        dateObligationEnds: '<string>',
        referenceNum: '<string>',
        brand: '<string>',
        email: '<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>',
    'keepBetterEBR' => 123,
    'ebrList' => [
        [
                'phoneNumber' => '<string>',
                'type' => '<string>',
                'dateOfLastContact' => '<string>',
                'dateObligationEnds' => '<string>',
                'referenceNum' => '<string>',
                'brand' => '<string>',
                'email' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "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  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\n}")

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

	req.Header.Add("loginId", "<loginid>")
	req.Header.Add("Content-Type", "<content-type>")

	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", "<content-type>")
  .body("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\",\n  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\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"] = '<content-type>'
request.body = "{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\",\n  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\n}"

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

[
  {
    "Phone": "5039367187",
    "ResultCode": "E",
    "Reserved": "",
    "Reason": "EBR",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "9740;RBOC;\"CenturyLink:CenturyLink\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "I",
    "IsWirelessOrVoIP": "0",
    "LineType": "AllOther",
    "EBRExpiresOn": "2021-02-09 23:59:00",
    "WirelessPortDate": "0",
    "VoIPDate": ""
  }
]

POST

app

main

rpc

scrub

Scrub + Add EBR

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/scrub \
  --header 'Content-Type: <content-type>' \
  --header 'loginId: <loginid>' \
  --data '
{
  "phoneList": "<string>",
  "version": "<string>",
  "output": "<string>",
  "projId": "<string>",
  "campaignId": "<string>",
  "keepBetterEBR": 123,
  "ebrList": [
    {
      "phoneNumber": "<string>",
      "type": "<string>",
      "dateOfLastContact": "<string>",
      "dateObligationEnds": "<string>",
      "referenceNum": "<string>",
      "brand": "<string>",
      "email": "<string>"
    }
  ]
}
'

import requests

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

payload = {
    "phoneList": "<string>",
    "version": "<string>",
    "output": "<string>",
    "projId": "<string>",
    "campaignId": "<string>",
    "keepBetterEBR": 123,
    "ebrList": [
        {
            "phoneNumber": "<string>",
            "type": "<string>",
            "dateOfLastContact": "<string>",
            "dateObligationEnds": "<string>",
            "referenceNum": "<string>",
            "brand": "<string>",
            "email": "<string>"
        }
    ]
}
headers = {
    "loginId": "<loginid>",
    "Content-Type": "<content-type>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {loginId: '<loginid>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    phoneList: '<string>',
    version: '<string>',
    output: '<string>',
    projId: '<string>',
    campaignId: '<string>',
    keepBetterEBR: 123,
    ebrList: [
      {
        phoneNumber: '<string>',
        type: '<string>',
        dateOfLastContact: '<string>',
        dateObligationEnds: '<string>',
        referenceNum: '<string>',
        brand: '<string>',
        email: '<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>',
    'keepBetterEBR' => 123,
    'ebrList' => [
        [
                'phoneNumber' => '<string>',
                'type' => '<string>',
                'dateOfLastContact' => '<string>',
                'dateObligationEnds' => '<string>',
                'referenceNum' => '<string>',
                'brand' => '<string>',
                'email' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "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  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\n}")

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

	req.Header.Add("loginId", "<loginid>")
	req.Header.Add("Content-Type", "<content-type>")

	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", "<content-type>")
  .body("{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\",\n  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\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"] = '<content-type>'
request.body = "{\n  \"phoneList\": \"<string>\",\n  \"version\": \"<string>\",\n  \"output\": \"<string>\",\n  \"projId\": \"<string>\",\n  \"campaignId\": \"<string>\",\n  \"keepBetterEBR\": 123,\n  \"ebrList\": [\n    {\n      \"phoneNumber\": \"<string>\",\n      \"type\": \"<string>\",\n      \"dateOfLastContact\": \"<string>\",\n      \"dateObligationEnds\": \"<string>\",\n      \"referenceNum\": \"<string>\",\n      \"brand\": \"<string>\",\n      \"email\": \"<string>\"\n    }\n  ]\n}"

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

[
  {
    "Phone": "5039367187",
    "ResultCode": "E",
    "Reserved": "",
    "Reason": "EBR",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "9740;RBOC;\"CenturyLink:CenturyLink\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "I",
    "IsWirelessOrVoIP": "0",
    "LineType": "AllOther",
    "EBRExpiresOn": "2021-02-09 23:59:00",
    "WirelessPortDate": "0",
    "VoIPDate": ""
  }
]

Scrub one or more phone numbers and add or refresh their Existing Business Relationship (EBR) records in a single request. This is the combined version of the Scrub and EBR and Consent endpoints: each number is checked against the DNC lists, and any EBR records you include in the same request are written before the result is returned, so the scrub result reflects the EBR you just submitted. Use this when your system establishes (or re-establishes) a business relationship at the same moment it needs a compliance decision — for example, logging an inquiry and immediately deciding whether the number is callable.

Each EBR you submit sets that number’s date of last contact to the date you provide and recalculates its expiration from that date. If you submit an EBR for the same number on every contact, its expiration window will roll forward each time and will not expire. Only submit an EBR when a genuine new business relationship event occurs, or use keepBetterEBR (see below) to avoid shortening or unintentionally extending an existing EBR. See EBR Expiration.

Request

Headers

Your API Key

string

required

Must be application/json

Request Body

string

required

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

string

default:"7"

required

API version. Use 7 (latest). Version 6 adds EBRExpiresOn — useful here to see the expiration of the EBR you just submitted; version 7 also adds WirelessPortDate and VoIPDate.

string

default:"json"

Response format: json or csv

string

Optional. Project ID

string

Optional. Campaign ID

integer

default:"0"

When set to 1, if an EBR record already exists for a number being submitted and the existing EBR is “better” than the one being added, the existing EBR is not overwritten. Federal EBR expiration dates determine which is better (longer remaining validity = better). Defaults to 0, which overwrites the existing EBR and resets its expiration window.

array

Optional. EBR records to add or refresh as part of this scrub. Each record applies to the phoneNumber it names, which should also appear in phoneList.

Show EBR Record Object

string

required

10-digit phone number(s). For multiple numbers, comma-separate them (e.g., "5039367187,7075276405").

string

required

EBR type. See EBR Types for the full list (e.g., S - Sale/Purchase, I - Inquiry, P - Permission).

string

required

Date of last contact in MM/DD/YYYY format (e.g., "11/11/2020").

string

Date when written obligation ends (New Jersey only).

string

Your internal tracking string.

string

Company/product/brand name used to establish the EBR.

string

Email address (100 characters max).

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",
    "version": "7",
    "output": "json",
    "keepBetterEBR": 0,
    "ebrList": [
      {
        "phoneNumber": "5039367187",
        "type": "I",
        "dateOfLastContact": "11/11/2020",
        "referenceNum": "OrderID-12345"
      }
    ]
  }'

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: "5039367187,7075276405",
    version: "7",
    output: "json",
    keepBetterEBR: 0,
    ebrList: [
      {
        phoneNumber: "5039367187",
        type: "I",
        dateOfLastContact: "11/11/2020",
        referenceNum: "OrderID-12345",
      },
    ],
  }),
});

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

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",
        version = "7",
        output = "json",
        keepBetterEBR = 0,
        ebrList = new[]
        {
            new
            {
                phoneNumber = "5039367187",
                type = "I",
                dateOfLastContact = "11/11/2020",
                referenceNum = "OrderID-12345"
            }
        }
    };

    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": "E",
    "Reserved": "",
    "Reason": "EBR",
    "RegionAbbrev": "OR",
    "Country": "US",
    "Locale": "Portland",
    "CarrierInfo": "9740;RBOC;\"CenturyLink:CenturyLink\"",
    "NewReassignedAreaCode": "",
    "TZCode": "4",
    "CallingWindow": "",
    "UTCOffset": "-420",
    "DoNotCallToday": "",
    "CallingTimeRestrictions": "4",
    "EBRType": "I",
    "IsWirelessOrVoIP": "0",
    "LineType": "AllOther",
    "EBRExpiresOn": "2021-02-09 23:59:00",
    "WirelessPortDate": "0",
    "VoIPDate": ""
  }
]

Response Fields

The response is identical to the standard Scrub response, one row per number in phoneList. Because the EBR is written before the scrub result is computed, the result reflects the EBR you submitted.

string

The scrub result code. Numbers with a valid EBR return an EBR-related code such as E, F, G, H, or O (see Output Guide).

string

The type of EBR currently on the record (e.g., I for Inquiry), or blank if the record has no EBR.

string

When the EBR expires, format YYYY-MM-DD HH:MM:SS. The earlier of the federal and state expiration dates — reflects the EBR you just submitted. Empty if no EBR. Requires version=6 or higher. The time portion is always 23:59:00 (end of day) and no timezone is included — treat the value as a date and compare against your local calendar date rather than parsing it as a UTC timestamp

How It Works

Any records in ebrList are added or refreshed, honoring keepBetterEBR.
Every number in phoneList is scrubbed against the DNC lists.
The scrub result — including any EBR exemption applied in step 1 — is returned.

A number can appear in phoneList without a matching ebrList entry (scrub only), and you can submit multiple EBR records in one request.

Best Practices

Submit EBRs Only on Real Contact Events

Submit an EBR when an actual business relationship event occurs (an inquiry, sale, or grant of permission) — not on every scrub. Re-submitting an EBR for the same number repeatedly resets its date of last contact and rolls the expiration window forward, which can keep an exemption alive longer than the relationship justifies.

Use keepBetterEBR to Avoid Downgrades

Set keepBetterEBR: 1 to preserve an existing EBR that has longer remaining validity instead of overwriting it with a shorter one.

Use Accurate Dates

The dateOfLastContact should be the actual date of the business relationship event, not the current date.

Output Format

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

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Request

Headers

Request Body

Example Request

Response Fields

How It Works

Best Practices

​Request

​Headers

​Request Body

​Example Request

​Response Fields

​How It Works

​Best Practices

Request

Headers

Request Body

Example Request

Response Fields

How It Works

Best Practices