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.
{
"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"
}
}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.What DNC Scrub does
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.
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.
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.
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.
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.
Fill in the field and run the lookup to see what comes back.
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)
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.
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| Plan | Per 1,000 credits | Per 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 |
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.
Related products
Phone Validation
Validity, carrier, line type, porting, DNC status and a risk level for any number.
Reported Number Check
How often a number was reported to the FTC in the last 12 months, and for what.
Skip Trace
Phone numbers and emails for a person, from a name and US mailing address.
Run DNC Scrub on your own data
Starter is $29 a month for 6,000 credits, enough for 600 lookups a month.