Skip to main content
Phone Scrub API

Check every US number against the Do Not Call Registry and known litigators before you dial

Send a US phone number and get its Do Not Call status, whether it belongs to a known litigator, serial complainer or attorney, its line type and a clear next step: approve, review or block. 10 credits when a number matches, about $0.05 on Starter, and nothing when it matches nothing. Scrub one number through the API or a whole list from a CSV.

10 credits per matched number · about $0.05 each on Starter · $0.04 on Growth · nothing when no match

10 credits

Per matched number

$0

When nothing matches

CSV or API

Bulk or one at a time

1Lookup phone scrub API cleaning a calling list by flagging DNC and litigator numbers before outreach

One scrub answers four questions about a number.

DNC list check, TCPA litigator list check, line type and what to do next

Do Not Call status

Each number is checked against the National Do Not Call Registry. A listed number comes back with doNotCall set to true and a BLOCK recommendation, so it never reaches the dialer by accident.

National DNC Registry
Line type in the same call
BLOCK on a listed number
One plain doNotCall field

Known litigator flag

Some numbers belong to people who sue over unwanted calls for a living: serial TCPA plaintiffs, frequent complainers and the attorneys who file for them. Those numbers come back with litigator set to true and BLOCK, never APPROVE, whatever else the record says.

Serial TCPA plaintiffs
Frequent complainers
Plaintiff attorneys
Always BLOCK, never APPROVE

Line type in the same call

Every scrubbed number also comes back as mobile, landline or VoIP, so you can route calls and texts without paying for a second lookup.

Mobile
Landline
VoIP
No second lookup

A decision, not just data

Each result carries a recommended action: APPROVE when the number matched and is clean, BLOCK when it is on a Do Not Call list or belongs to a litigator, and REVIEW when nothing matched.

APPROVE
REVIEW
BLOCK
Do not contact message

Outbound teams scrub at four points in a campaign.

Where a scrub saves money, and the rules that make it worth doing

Scrub before every campaign

The FTC's Telemarketing Sales Rule says a seller must work from a copy of the Do Not Call Registry that is no more than 31 days old. Scrub each list when it loads and again before it dials.

The 31-day rule
  • Scrub at list load
  • Re-scrub before dialing
  • Keep the scrub date per list
  • Drop every BLOCK

Keep litigators out of the dialer

The TCPA lets a person on the Do Not Call Registry who gets more than one telemarketing call in a year claim up to $500 per call, and up to $1,500 when the violation is willful. Serial plaintiffs know those numbers, so their phones are worth removing before anyone dials.

Up to $1,500 per call
  • Litigator flag on every result
  • BLOCK, never APPROVE
  • Works in bulk and by API
  • One call per number

Route calls by line type

Send mobiles, landlines and VoIP numbers down different paths in your dialer or texting tool, using the line type that comes back with every scrub.

Line type included
  • Mobile, landline, VoIP
  • Same response as the DNC flag
  • No extra credits
  • Works on whole lists

Clean a whole file at once

Upload a CSV on the Do Not Call check page of the 1Lookup dashboard and every row comes back with its result. Numbers that do not match anything cost nothing.

CSV upload
  • Upload a CSV
  • Download the scrubbed file
  • Pay only for matches
  • Same credits as every lookup

Every result tells you whether to dial the number.

A scrub ends in one of four results. This is what each one means and what to do with the number.

ResultActionWhat it meansWhat to do
doNotCall: trueBLOCKThe number is on the National Do Not Call Registry.Do not call or text it for telemarketing. Keep the scrub date as your record.
litigator: trueBLOCKThe number belongs to a known TCPA litigator, serial complainer or attorney.Do not contact it at all, even when it is not on a Do Not Call list.
matched, cleanAPPROVEThe number matched and carries neither flag. Its line type comes back with it.Keep it on the list and route it by line type.
no matchREVIEWNothing matched the number, so there is no status to report. You are not charged.Check it another way before you dial, for example with phone validation.

Not sure whether a number is real before you scrub it? Phone validation checks that first, and the federal Do Not Call list guide explains who must scrub and how often. To check one number before a call, use the free DNC check, and to see whether a number is valid at all, try the free phone validator.

Four things set this scrub apart from a plain registry download.

More flags, fewer lookups, and no charge for numbers that match nothing

It catches litigators, not just registry numbers

A registry download only tells you who opted out. This scrub also flags the people most likely to sue.

You pay only for matches

A matched number costs 10 credits. A number that matches nothing costs nothing.

One call returns three answers

Do Not Call status, the litigator flag and the line type come back together.

The same credits as every other lookup

Scrubs draw on your universal 1Lookup credits, so there is no separate compliance subscription.

One API call scrubs one number.

The same check runs on whole lists through the dashboard's CSV upload

POST /api/v1/phone-scrub
// Scrub one number: 10 credits when it matches, nothing when it does not
const response = await fetch('https://app.1lookup.io/api/v1/phone-scrub', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ phone_number: '12125550001' })
})

// Response
{
  "success": true,
  "data": {
    "request": { "type": "phone_scrub", "input": "12125550001" },
    "metadata": { "credits_used": 10, "credits_remaining": 9990, "cache_hit": false },
    "classification": {
      "matched": true,
      "phoneTypeLabel": "MOBILE",
      "doNotCall": false,
      "litigator": false
    },
    "recommendations": { "primary_action": "APPROVE" }
  }
}

A DNC list check and a TCPA litigator list check run in the same call.

One scrub is your DNC lookup and litigator screen, by API or CSV

DNC list check and DNC lookup

The DNC list check compares each US number with the National Do Not Call Registry. When the DNC lookup finds a listed number, it comes back with doNotCall set to true and a BLOCK recommendation, so it never reaches the dialer by accident.

TCPA litigator list check

The same call checks the number against a TCPA litigator list of known serial plaintiffs, frequent complainers and the attorneys who file for them. A number on the TCPA litigator list comes back with litigator set to true and BLOCK, never APPROVE, even when it is not on a Do Not Call list.

Run the DNC check one number at a time through the API, or upload a CSV on the Do Not Call check page of the 1Lookup dashboard to check a whole list. The line type comes back in the same call.

Teams ask these questions before their first scrub.

Coverage, cost, litigators and how often to scrub

These are the phone scrub API's technical details.

Credits

10 per match

No match

Free

DNC Coverage

National registry

Input

phone_number

Litigator Flag

Included

Bulk

CSV upload

You can scrub your first list on the free trial today.

Get Do Not Call status, the litigator flag and line type with every lookup

7-day free trial • Setup in 5 minutes • Premium support