API Authentication

CCC APIs support two authentication methods:

API Key: Passed in the request headers for every call. The API key is also referred to Was the LoginId.
OAuth 2.0 Available for systems that require token-based authorization flows.

API Key Authentication

Create an API User

In the DNCScrub portal, navigate to User Admin. Create a new user that will be used for API access.

Give the user a distinct full name like “API User - Do Not Delete” so it won’t be accidentally removed
The recommended username is apiuser (though any username works)
Set the user role to Administrator

Generate the API Key

After creating the user, click the “Get API Key” button. The API Key will be displayed in the “API Key” field and can be copied to your clipboard.

Store Your API Key

Save your API Key securely. You’ll need it for all API calls.

Using Your API Key

Include the API key in the HTTP header of every request:

Header Key	Value
`loginId`	Your API Key

Example with cURL

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

Example with JavaScript

fetch(
  "https://www.dncscrub.com/app/main/rpc/scrub?phoneList=7075276405&version=5&output=json",
  {
    method: "GET",
    headers: {
      loginId: "YOUR_API_KEY_HERE",
    },
  }
);

Example with C#

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

Keep your API key secure and never expose it in client-side code or public repositories.

OAuth 2.0 Authentication

For enhanced security, CCC APIs support OAuth 2.0 authentication in addition to API key authentication.

OAuth Token API Playground

Try the OAuth token endpoint directly in the API playground.

OAuth Flow

Request Credentials

Contact support to receive your OAuth client credentials.

Get Access Token

Exchange credentials for an access token.

Make API Calls

Include the access token in API requests.

Refresh Token

Refresh the token before it expires (tokens expire after 1 hour).

Token Request

curl --location --request POST 'https://api.dncscrub.com/oauth/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id=YOUR_ACCOUNT_ID' \
  --data-urlencode 'client_secret=YOUR_CLIENT_SECRET'

Request Parameters

Parameter	Condition	Description
`client_id`	Required	Your Account Id such as DEMO
`client_secret`	Required	An API Key generated from DNCScrub.com portal.
`grant_type`	Required	Must be set to `client_credentials`

Using the Access Token

curl --location --request GET 'https://www.dncscrub.com/app/main/rpc/scrub?phoneList=7075276405&version=5' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

API Key Authentication

Using Your API Key

Example with cURL

Example with JavaScript

Example with C#

OAuth 2.0 Authentication

OAuth Token API Playground

OAuth Flow

Token Request

Request Parameters

Using the Access Token

​API Key Authentication

​Using Your API Key

​Example with cURL

​Example with JavaScript

​Example with C#

​OAuth 2.0 Authentication

OAuth Token API Playground

​OAuth Flow

​Token Request

​Request Parameters

​Using the Access Token

API Key Authentication

Using Your API Key

Example with cURL

Example with JavaScript

Example with C#

OAuth 2.0 Authentication

OAuth Flow

Token Request

Request Parameters

Using the Access Token