JavaScript Code Examples

Complete JavaScript examples for integrating with CCC APIs. These examples work in both Node.js and browser environments.

In browser environments, API calls may be blocked by CORS. These APIs are designed for server-side use. For client-side applications, make calls through your backend.

Scrub API - Basic Example

async function scrubPhoneNumber(phoneNumber, apiKey) {
  const url = `https://www.dncscrub.com/app/main/rpc/scrub?phoneList=${phoneNumber}&version=5&output=json`;

  const response = await fetch(url, {
    method: 'GET',
    headers: {
      'loginId': apiKey
    }
  });

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();
  return data[0];
}

// Usage
const result = await scrubPhoneNumber('7075276405', 'YOUR_API_KEY');
console.log(`Result Code: ${result.ResultCode}`);
console.log(`Reason: ${result.Reason}`);

Scrub Multiple Phone Numbers

async function scrubMultipleNumbers(phoneNumbers, apiKey) {
  const phoneList = phoneNumbers.join(',');
  const url = `https://www.dncscrub.com/app/main/rpc/scrub?phoneList=${phoneList}&version=5&output=json`;

  const response = await fetch(url, {
    method: 'GET',
    headers: {
      'loginId': apiKey
    }
  });

  const results = await response.json();

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

  return {
    all: results,
    clean,
    doNotCall,
    wireless,
    summary: {
      total: results.length,
      cleanCount: clean.length,
      dncCount: doNotCall.length,
      wirelessCount: wireless.length
    }
  };
}

// Usage
const numbers = ['5039367187', '7075276405', '7072842774'];
const results = await scrubMultipleNumbers(numbers, 'YOUR_API_KEY');
console.log(`Clean: ${results.summary.cleanCount}`);
console.log(`DNC: ${results.summary.dncCount}`);

Scrub with Unique Identifiers

async function scrubWithIds(records, apiKey) {
  // records = [{ phone: '5039367187', id: 'ACCT-001' }, ...]

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

  const url = `https://www.dncscrub.com/app/main/rpc/scrub?phoneList=${encodeURIComponent(phoneList)}&version=5&output=json`;

  const response = await fetch(url, {
    headers: { 'loginId': apiKey }
  });

  const results = await response.json();

  // Results have your ID in the Reserved field
  return results.map(r => ({
    phone: r.Phone,
    accountId: r.Reserved,  // Your unique ID
    resultCode: r.ResultCode,
    reason: r.Reason
  }));
}

// Usage
const records = [
  { phone: '5039367187', id: 'ACCT-001' },
  { phone: '7075276405', id: 'ACCT-002' }
];
const results = await scrubWithIds(records, 'YOUR_API_KEY');

HTTP POST for Large Batches

async function scrubLargeBatch(phoneNumbers, apiKey) {
  const response = await fetch('https://www.dncscrub.com/app/main/rpc/scrub', {
    method: 'POST',
    headers: {
      'loginId': apiKey,
      'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: new URLSearchParams({
      phoneList: phoneNumbers.join(','),
      version: '5',
      output: 'json'
    })
  });

  return await response.json();
}

TCPA Authority API

async function checkReassigned(phoneNumber, consentDate, apiKey) {
  const url = `https://dataapi.dncscrub.com/v1.4/Data/TCPAAuthority?phoneNumber=${phoneNumber}&date=${consentDate}`;

  const response = await fetch(url, {
    headers: { 'loginId': apiKey }
  });

  const result = await response.json();

  return {
    phoneNumber: result.PhoneNumber,
    isReassigned: result.IsReassigned,
    isValid: result.IsValid,
    lineType: result.LineType,
    carrier: result.Carrier,
    location: `${result.Locale}, ${result.Region}`,
    timezone: result.TZ
  };
}

// Usage
const result = await checkReassigned('7075276405', '20210209', 'YOUR_API_KEY');

if (result.isReassigned === true) {
  console.log('DO NOT CALL - Number reassigned');
} else if (result.isReassigned === false) {
  console.log('Safe to call');
} else {
  console.log('Unable to determine - proceed with caution');
}

Litigator API

async function checkLitigators(phoneNumbers, apiKey) {
  const phoneList = phoneNumbers.join(',');
  const url = `https://dataapi.dncscrub.com/v1.4/scrub/litigator?phoneList=${phoneList}`;

  const response = await fetch(url, {
    headers: { 'loginId': apiKey }
  });

  const results = await response.json();

  const litigators = results.filter(r => r.IsLitigator);
  const safe = results.filter(r => !r.IsLitigator);

  return { litigators, safe };
}

// Usage
const { litigators, safe } = await checkLitigators(['5039367187', '7075276405'], 'YOUR_API_KEY');
console.log(`Litigators found: ${litigators.length}`);

Internal DNC Management

// Add to Internal DNC
async function addToInternalDNC(phoneNumber, apiKey) {
  const url = `https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=${phoneNumber}&actionType=add`;

  const response = await fetch(url, {
    headers: { 'loginId': apiKey }
  });

  return response.ok;
}

// Remove from Internal DNC
async function removeFromInternalDNC(phoneNumber, apiKey) {
  const url = `https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=${phoneNumber}&actionType=remove`;

  const response = await fetch(url, {
    headers: { 'loginId': apiKey }
  });

  return response.ok;
}

TrustCall Premier API

// Add numbers to monitoring
async function addToTrustCall(numbers, apiKey) {
  const response = await fetch('https://trustcallapi.dncscrub.com/v1.4/trustcall/add', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'loginId': apiKey
    },
    body: JSON.stringify(numbers.map(phone => ({ Phone: phone })))
  });

  return await response.json();
}

// Check scores
async function getTrustCallScores(phoneNumbers, apiKey) {
  const phoneList = phoneNumbers.join(',');
  const url = `https://trustcallapi.dncscrub.com/v1.4/trustcall/get?phoneList=${phoneList}`;

  const response = await fetch(url, {
    headers: {
      'Content-Type': 'application/json',
      'loginId': apiKey
    }
  });

  return await response.json();
}

Error Handling Wrapper

class CCCApiClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://www.dncscrub.com/app/main/rpc';
  }

  async request(endpoint, options = {}) {
    const url = `${this.baseUrl}${endpoint}`;

    try {
      const response = await fetch(url, {
        ...options,
        headers: {
          'loginId': this.apiKey,
          ...options.headers
        }
      });

      if (response.status === 401) {
        throw new Error('Invalid API Key');
      }

      if (response.status === 429) {
        throw new Error('Rate limit exceeded');
      }

      if (!response.ok) {
        const error = await response.text();
        throw new Error(`API Error: ${error}`);
      }

      const contentType = response.headers.get('content-type');
      if (contentType?.includes('application/json')) {
        return await response.json();
      }
      return await response.text();

    } catch (error) {
      if (error.name === 'TypeError') {
        throw new Error('Network error - check your connection');
      }
      throw error;
    }
  }

  async scrub(phoneNumbers) {
    const phoneList = Array.isArray(phoneNumbers) ? phoneNumbers.join(',') : phoneNumbers;
    return this.request(`/scrub?phoneList=${phoneList}&version=5&output=json`);
  }
}

// Usage
const client = new CCCApiClient('YOUR_API_KEY');
try {
  const results = await client.scrub(['5039367187', '7075276405']);
  console.log(results);
} catch (error) {
  console.error('API Error:', error.message);
}

HTML Form Example

A complete HTML example for browser-based scrubbing (through your backend):

<!DOCTYPE html>
<html>
<head>
  <title>Phone Scrubber</title>
</head>
<body>
  <h2>Phone Number Scrubber</h2>
  <form id="scrubForm">
    <label>Phone Number (10 digits):</label>
    <input type="text" id="phoneNumber" placeholder="5039367187" required>
    <button type="submit">Scrub</button>
  </form>
  <div id="results"></div>

  <script>
    document.getElementById('scrubForm').addEventListener('submit', async (e) => {
      e.preventDefault();

      const phone = document.getElementById('phoneNumber').value.replace(/\D/g, '');
      const resultsDiv = document.getElementById('results');

      // Call YOUR backend, which calls CCC API
      const response = await fetch(`/api/scrub?phone=${phone}`);
      const data = await response.json();

      resultsDiv.innerHTML = `
        <p><strong>Phone:</strong> ${data.Phone}</p>
        <p><strong>Result:</strong> ${data.ResultCode}</p>
        <p><strong>Reason:</strong> ${data.Reason}</p>
        <p><strong>Line Type:</strong> ${data.LineType}</p>
      `;
    });
  </script>
</body>
</html>

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

JavaScript Examples

JavaScript Code Examples

Scrub API - Basic Example

Scrub Multiple Phone Numbers

Scrub with Unique Identifiers

HTTP POST for Large Batches

TCPA Authority API

Litigator API

Internal DNC Management

TrustCall Premier API

Error Handling Wrapper

HTML Form Example

​JavaScript Code Examples

​Scrub API - Basic Example

​Scrub Multiple Phone Numbers

​Scrub with Unique Identifiers

​HTTP POST for Large Batches

​TCPA Authority API

​Litigator API

​Internal DNC Management

​TrustCall Premier API

​Error Handling Wrapper

​HTML Form Example

JavaScript Code Examples

Scrub API - Basic Example

Scrub Multiple Phone Numbers

Scrub with Unique Identifiers

HTTP POST for Large Batches

TCPA Authority API

Litigator API

Internal DNC Management

TrustCall Premier API

Error Handling Wrapper

HTML Form Example