Free on every lookup
Set dncState: true and dncComplainer: true on any lookup to run the state do-not-call check, which covers 38 states plus DC and is refreshed weekly, and to screen the number against our national list of roughly 700,000 telemarketing complainers. Both checks are free, and each one reports whether it ran, so "not checked" never reads as clear.
| Number | The lookup says | Do this |
|---|---|---|
| (916) 555-0134 | California, state DNC match | Suppress |
| (214) 555-0172 | Texas, not in our state check | Scrub it yourself |
| (312) 555-0155 | Illinois, known DNC complainer | Suppress |
| (503) 555-0110 | Oregon, clear on both checks | Keep |
| (416) 555-0188 | Canadian, state check is US-only | Check the DNCL |
Fictional 555 numbers.
Yes. The FCC applies its do-not-call rules to telephone solicitations by call or text message to wireless numbers. The checks work the same whichever channel you use.
47 CFR 64.1200(e) · ecfr.gov
dncStateResultdncComplainerResult The FCC's safe harbor expects a version of the national registry no more than 31 days old. That scrub stays yours; these checks add state and complainer data on top.
47 CFR 64.1200(c)(2)(i)(D) · ecfr.gov
dncStateCheckeddncComplainerChecked The state check doesn't cover CO, FL, IN, LA, MA, MS, MO, OK, PA, TN, TX and WY. For numbers there, dncStateChecked is left out of the response. Absent always means not checked, never clear.
dncStateChecked More than one call in 12 months that breaks the do-not-call rules lets the person sue for up to $500 per violation, or up to three times that if it was willful.
47 U.S.C. 227(c)(5) · law.cornell.edu
dncStateResultdncComplainerResult Teams that run it: real estate agents and investors, insurance lead buyers, call centers, SMS marketers and lead sellers.
Both checks are free, so set dncState: true and dncComplainer: true on every lookup you already make, or tick State DNC and DNC complainers on a CSV upload. The older dncOther flag still turns on both, but it is deprecated.
Suppress on a match unless you hold documented consent, trust a clear state result only when dncStateChecked is "true", and fall back to your own per-state scrub when it is absent. Log dncStateChecked and dncComplainerChecked with the results for your audit trail.
The state data refreshes weekly, so re-scrub long-running lists at least that often. The TCPA litigator scrub (+1 credit) catches a different group: known TCPA litigators.
Each check reports itself only when it ran. An absent dncStateChecked or dncComplainerChecked means not checked, never clear.
| If the response shows | Field | Do this |
|---|---|---|
| State do-not-call match | dncStateResult = STATE DNC | Suppress unless your consent records say otherwise. |
| State check ran, no match | dncStateChecked = "true"dncStateResult | Clear for the state check. The national registry is still yours to scrub. |
| State check absent (CO, FL, IN, LA, MA, MS, MO, OK, PA, TN, TX and WY) | dncStateChecked | Not checked. Use your own scrub for that state. |
| A check could not complete | dncStateChecked = "error"dncComplainerChecked = "error" | Treat that result as unavailable, never as clear. Retry, or handle it as not checked. |
| On our national complainer list | dncComplainerResult = DNC COMPLAINER | Suppress, or route to review, per your policy. The complainer check runs nationwide, whatever the state. |
| Any DNC match | action | Unlike a litigator match, a DNC match never changes action. Whether a registered number is contactable depends on your consent records, so your suppression logic decides. |
| A Canadian number | geoCountry | The state check is US-only and Canada's National DNCL isn't checked. Scrub Canadian numbers against the DNCL. |
A mobile with a state do-not-call match. Credits used stay at 1 because the checks are free, and action stays "send": a DNC match is informational, so the routing decision stays yours. dncOtherChecked and dncStateCovered are legacy fields kept for existing integrations.
Highlighted fields: action, dncStateChecked, dncStateResult, dncComplainerChecked, dncComplainerResult.
{
"success": true,
"credits_used": 1,
"data": {
"subscriber": "9165550134",
"optDate": "2026-10-08T17:01:48.188Z",
"action": "send",
"deliverable": "true",
"nanpType": "mobile",
"blackList": "false",
"dip": "success",
"dipLrn": "9165550134",
"dipPorted": "false",
"dipOcn": "6010",
"dipCarrierSubType": "WIRELESS",
"dipCarrier": "AT&T",
"dipCarrierType": "mobile",
"dncStateChecked": "true",
"dncStateResult": "STATE DNC",
"dncComplainerChecked": "true",
"dncComplainerResult": "",
"dncOtherChecked": "true",
"dncStateCovered": "true",
"geoState": "CA",
"geoCity": "sacramento",
"geoCountry": "US",
"timezone": "America/Los_Angeles",
"tzOffset": 8,
"geoSource": "area-code",
"error": "false",
"smsEligible": "true"
}
}Monthly cost, without the TCPA litigator scrub:
These are lookup credits only: the state DNC and complainer checks add nothing, on every plan, including the free tier and CSV uploads. The landline SMS check adds 1 credit per landline.
Not legal advice.
dncStateChecked is left out for them, so "not checked" never reads as clear.deactivationDate: data refreshed daily, with a 1 to 7 day lag, and entries expire after 45 days. It is not a reassigned-number check.No. They are free on every plan, including the free tier and CSV uploads: a lookup with both checks costs the same 1 credit as a lookup without them. The TCPA litigator scrub and the landline SMS check are the add-ons that add a credit.
38 states plus DC, refreshed weekly. It doesn't cover Colorado, Florida, Indiana, Louisiana, Massachusetts, Mississippi, Missouri, Oklahoma, Pennsylvania, Tennessee, Texas and Wyoming. For numbers there the state check doesn't run and dncStateChecked is left out, so you can tell per number which situation you are in.
No. Unlike a litigator match, a DNC match never rewrites action. Whether a registered number is contactable depends on your consent records, so your suppression logic decides.
No. Scrub against the National Do Not Call Registry separately: access comes from the FTC at telemarketing.donotcall.gov, and the FCC's safe harbor expects a copy no more than 31 days old (47 CFR 64.1200(c)(2)(i)(D)).
The FCC applies its do-not-call rules to telephone solicitations by call or text message to wireless numbers (47 CFR 64.1200(e)). The checks return the same fields whichever channel you use.
The state check is US-only, and Canada's National DNCL isn't checked, so scrub Canadian numbers against the DNCL yourself.
Free on every plan, including the free tier and CSV uploads.