Skip to content

DNC scrub API: registry status and litigator flag

Check a US number against the National Do Not Call registry, state lists where available and known TCPA litigators. You also get line type and a call or do-not-call recommendation with reasons. 10 credits per lookup.

10 creditsValidateCSV bulkMCP
POST/v1/dnc-scrub
{
  "success": true,
  "data": {
    "phone_number": "+15125550142",
    "national_dnc": {
      "listed": true
    },
    "state_dnc": {
      "state": "TX",
      "available": true,
      "listed": false
    },
    "litigator": {
      "flagged": false
    },
    "line_type": "mobile",
    "recommendation": "do_not_call",
    "reasons": [
      "national_dnc_listed"
    ]
  },
  "meta": {
    "credits_used": 10,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

national_dnc.listedNational DNCWhether the number is on the National Do Not Call registry.
state_dnc.availableState list checkedWhether the number's state has its own Do Not Call list that could be checked.
state_dnc.listedState DNCWhether the number appears on that state list.
litigator.flaggedKnown litigatortrue when the number matches a known TCPA litigator.
line_typeLine typemobile, landline or voip, because calling rules differ for wireless numbers.
recommendationRecommendationcall or do_not_call, a summary of the checks above.
reasonsReasonsThe specific findings behind the recommendation, as codes you can store.
[02/Capabilities]

What DNC Scrub does

01

Federal and state lists in one pass

Each number is checked against the National Do Not Call registry and, where a state publishes its own list, that list too. The response says which lists were checked and which ones matched.

02

A flag for known TCPA litigators

Some people file telemarketing lawsuits repeatedly. If a number matches a known litigator, the flag is set so you can suppress it whatever its registry status.

03

Line type for your calling policy

US calling rules treat wireless numbers differently from landlines. Line type is returned with every scrub so your dialer can apply the policy your counsel has set for each one.

04

A recommendation you can audit

The response ends with call or do_not_call and the reasons that produced it. Store both with the time of the check and you have a record of what was looked at before each dial.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/dnc-scrub10 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/dnc-scrub \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+15125550142"}'
Endpoint
POST /v1/dnc-scrub
Base URL
https://api.1lookup.dev
Request
phone_number
Price
10 credits
Coverage
US
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Scrub a list before each campaign

Upload the file as a CSV, split it on the recommendation field and load only the call records into your dialer. Keep the output file as a record of the scrub.

Check leads as they arrive

Call the API when a web lead or live transfer lands. Suppress numbers flagged as litigators and send registry matches to a consent review instead of the dial queue.

Re-scrub a standing list

Registry status changes as people add their numbers. Re-run active lists on a regular schedule so a number registered last week does not stay in rotation.

Vet purchased data

Scrub a sample before you pay for a lead file. The share of registry and litigator hits tells you how much of the file you could ever dial.

DNC Scrub is an input to a compliance process, not compliance itself. Sellers and telemarketers have their own registry obligations. Nothing on this page is legal advice.

[06/Cost]

10 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$48.33
Growth $99/mo$3.96$39.60
Pro $299/mo$3.32$33.22
Scale $799/mo$2.66$26.63
[07/FAQ]

DNC Scrub questions

What does a DNC scrub check?

National Do Not Call registry status, state Do Not Call status where a state list is available, a known TCPA litigator flag and line type. It then returns a call or do_not_call recommendation with the reasons.

Does scrubbing make my campaign TCPA compliant?

No. A scrub is one input to a compliance process. Consent, calling hours, your internal do-not-call list and your own registry obligations still apply. This is not legal advice, so review your program with counsel.

How much does a scrub cost?

Ten credits per number. That single charge covers the national registry, state lists, the litigator check and line type.

Is it available outside the US?

No, it works on US numbers only. State Do Not Call data is returned where a state maintains a list, and the response marks the states where none is available.

Do I still need my own access to the National Do Not Call Registry?

Sellers and telemarketers that call US consumers generally have their own duties to register with and access the registry. This lookup does not take the place of those duties. Ask your counsel what applies to you.

[ Validate ][ Enrich ]
[Get started]

Run DNC Scrub on your own data

Starter is $29 a month for 6,000 credits, enough for 600 lookups a month.

[ Screen ][ Scrape ]