API v2 is now live

Enterprise-Grade TCPA & DNC Scrubbing API

The ultimate backbone for CRMs and dialers. Instantly identify carriers, detect wireless vs. landline, and map numbers against national DNC registries and serial litigator databases in a single millisecond request.

Unmatched Compliance

Everything you need in one payload

Carrier & Line Type

Instantly map numbers to Verizon, T-Mobile, or Comcast. Accurately detect if a number is Wireless, Landline, or VoIP to route SMS properly.

National DNC Scrub

Cross-reference numbers against federal and state Do-Not-Call registries to seamlessly segment your 10-day vs 90-day inquiry outreach buckets.

Serial Litigator DB

Protect your business from TCPA lawsuits by automatically flagging known serial plaintiffs and professional litigators before you dial.

API Reference

Integrate Scrubber into your CRM, dialer, or custom application to automate your compliance. All API requests must be authenticated using your unique API Key.

Authentication Strategy

Your API key should be passed directly in the JSON payload of your POST request under the apiKey property. You can generate and revoke keys anytime in your Admin Portal.

Batch Scrub Endpoint

Send a POST request containing an array of 10-digit US phone numbers and your API key. We recommend batching numbers in groups of 100-500 for optimal latency.

POST https://api.usescrubber.com/v1/scrub

Integration Examples

Copy these snippets to get up and running in seconds. Select your preferred language below.

curl -X POST "https://api.usescrubber.com/v1/scrub" \
-H "Content-Type: application/json" \
-d '{
  "apiKey": "sk_live_abc123def456",
  "numbers": [
    "4703903967",
    "4046106924"
  ]
}'

const fetch = require('node-fetch');

const data = {
  apiKey: 'sk_live_abc123def456',
  numbers: ['4703903967', '4046106924']
};

fetch('https://api.usescrubber.com/v1/scrub', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(data)
})
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));

import requests
import json

url = "https://api.usescrubber.com/v1/scrub"
payload = {
    "apiKey": "sk_live_abc123def456",
    "numbers": ["4703903967", "4046106924"]
}
headers = {"Content-Type": "application/json"}

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

<?php
$url = 'https://api.usescrubber.com/v1/scrub';
$data = array(
    'apiKey' => 'sk_live_abc123def456',
    'numbers' => array('4703903967', '4046106924')
);

$options = array(
    'http' => array(
        'header  => "Content-Type: application/json\r\n",
        'method  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
var_dump(json_decode($result, true));
?>

Response Schema

The API returns a JSON array of objects mapping the precise attributes of each requested number.

Property	Type	Description
phone	String	The 10-digit string queried.
valid	Boolean	`true` if confirmed as standard formatting, `false` if invalid.
lineType	String	Returns `Wireless`, `Landline`, `VoIP`, or `Unknown`.
carrier	String	Current carrier network name (e.g., "Verizon Wireless").
dncStatus	Enum	`FLAGGED` (on state/federal DNC), `CLEAN`, or `UNVERIFIED`.
litigatorStatus	Enum	`FLAGGED` (Known Litigator), `CLEAN`, or `UNVERIFIED`.

Error Codes

Scrubber uses standard HTTP response codes to indicate the success or failure of an API request.

Code	Status	Resolution
200	Success	Request processed successfully. Body contains data array.
400	Bad Request	Missing payload, malformed JSON, or missing `numbers` array.
401	Unauthorized	Invalid or missing `apiKey`. Verify key in Admin Portal.

Rate Limits & Best Practices

Batch Sizes: For optimal performance and to prevent CRM webhook timeouts, send a maximum of 500 numbers per request.
Formatting: Strip all special characters before sending. E.g., (404) 555-1234 should be sent as "4045551234".

Frequently Asked Questions

How often is the DNC registry updated?

Our backbone services sync with the Federal Trade Commission (FTC) National Do Not Call Registry and state-specific registries daily. Serial litigator databases are updated in real-time as new court filings are logged.

What constitutes a "Litigator"?

A flagged litigator is a phone number historically associated with professional plaintiffs who intentionally set traps to file TCPA (Telephone Consumer Protection Act) lawsuits against businesses. Flagging these numbers before dialing is the #1 way to prevent devastating lawsuits.

Do you support international numbers?

Currently, Scrubber is optimized for the North American Numbering Plan (NANP), covering the United States and Canada (10-digit format). We do not currently scrub European or Asian registries.

Volume Pricing

Tailored plans for your traffic

Get volume-based tiered pricing or start with a free trial today to test the payload.

Custom Enterprise Plan

Comprehensive compliance solutions tailored for high-volume dialers and call centers. Talk to sales to establish your volume tier.

Starts at $0.01 / lookup

Covers Everything: Carrier, Line Type, National/State DNC, and Serial Litigators.
Dedicated Account Manager & Integration Support.
Significant volume discounts for heavy usage.

Start Free Trial

10 Free Lookups

Create your trial portal account today. You'll instantly receive a temporary token for 10 free API transactions.

First Name

Last Name

Company

Phone Number

Password

Must be at least 8 characters containing letters and numbers.

Repeat Password

Contact Sales & Support

We typically respond within 2-4 hours during business days.

Terms of Service

Effective Date: August 20, 2026

1. Acceptance of Terms

By accessing or using the Scrubber API, dashboard, and related services ("Services"), you agree to be bound by these Terms of Service. If you do not agree to these terms, do not use our services. Scrubber, Inc. reserves the right to modify these terms at any time.

2. API Usage & Compliance Responsibilities

You agree to use the Scrubber API strictly in accordance with all applicable local, state, and federal laws, including the Telephone Consumer Protection Act (TCPA) and the Telemarketing Sales Rule (TSR). Scrubber acts solely as a data conduit and does not provide legal advice. You are solely responsible for how your organization utilizes the data returned by our API to govern your outreach strategies.

3. Rate Limits, SLA, & Abuse

Free trial accounts are strictly limited to the transaction amounts assigned upon creation and may not be used in production environments. Enterprise accounts are subject to the rate limits defined in your specific Master Services Agreement (MSA). Abuse of the API, unauthorized sharing of API keys, or attempts to bypass rate limits will result in immediate API key revocation without refund.

Privacy Policy

Effective Date: August 20, 2026

1. Data Collection & Processing

When you use the Scrubber API, we process the 10-digit phone numbers transmitted via your API payload. We operate under a strict data minimization policy: we do not store these numbers permanently, nor do we sell, rent, or distribute this data to third-party data brokers. Numbers are processed ephemerally solely to return carrier, line type, and compliance statuses to you.

2. Account Information

We collect standard account information (Name, Email, Company Name, Payment Details) for billing, authentication, and communication purposes. This data is stored securely using industry-standard encryption and is never shared outside of Scrubber's essential operating vendors (e.g., payment processors like Stripe).

3. Security

We employ administrative, technical, and physical safeguards to protect your API keys and account data. However, you are responsible for maintaining the confidentiality of your API keys. If you suspect your key has been compromised, you must revoke it immediately via your Admin Portal.

Enterprise-Grade TCPA & DNC Scrubbing API

Unmatched Compliance

Carrier & Line Type

National DNC Scrub

Serial Litigator DB

API Reference

Authentication Strategy

Batch Scrub Endpoint

Integration Examples

Response Schema

Error Codes

Rate Limits & Best Practices

Frequently Asked Questions

How often is the DNC registry updated?

What constitutes a "Litigator"?

Do you support international numbers?

Volume Pricing

Custom Enterprise Plan

Start Free Trial

Portal Access Granted!

Contact Sales & Support

Terms of Service

1. Acceptance of Terms

2. API Usage & Compliance Responsibilities

3. Rate Limits, SLA, & Abuse

Privacy Policy

1. Data Collection & Processing

2. Account Information

3. Security

Subscribe to compliance updates