Skip to main content
CCC APIs support two authentication methods:
  1. API Key: Passed in the request headers for every call. The API key is also referred to Was the LoginId.
  2. OAuth 2.0 Available for systems that require token-based authorization flows.

​
API Key Authentication

1

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
2

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.
3

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 KeyValue
loginIdYour 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

1

Request Credentials

Contact support to receive your OAuth client credentials.
2

Get Access Token

Exchange credentials for an access token.
3

Make API Calls

Include the access token in API requests.
4

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

ParameterConditionDescription
client_idRequiredYour Account Id such as DEMO
client_secretRequiredAn API Key generated from DNCScrub.com portal.
grant_typeRequiredMust 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'