Log in Get an API key

API Reference › Phone Verification & DNC

DNC Lookup

POST /v2/api/dnc/lookup/

Cost: 5 credits per lookup. 0 when the DNC service fails.

Rate limit: 120 lookups per minute per account. Each array item counts as one.

Mode: Sync

Synchronous DNC check. Send one phone object or an array of up to 15 phone objects and get Federal DNC, state DNC, and TCPA litigator flags back immediately. No queue, no CSV, no waiting. Array requests: results stay in input order, each item is validated and billed independently, and the response returns results plus aggregate credits_deducted. Each phone counts toward the lookup rate limit. 5 credits per lookup. Rate limited to 120 lookup items per minute per account. Use this when: you need to check a single number before dialing or as part of a real-time CRM workflow. For bulk scrubbing (100+ phones), use POST /v2/api/dnc/scrub/ instead, it isn't subject to the synchronous 120-item-per-minute limit. Response fields: - national_dnc: on the Federal Do Not Call Registry - state_dnc: on at least one state DNC registry - state_dnc_list: array of the state codes matched, e.g. ["FL", "TX"]; empty when state_dnc is false - litigator: known TCPA litigator - is_clean: true only if no flags are set Not returned by v2: dma and phone_type. See DNC API Versions. ⚠️ Compliance: Phones returning litigator: true or national_dnc: true should not be called for telemarketing or cold outreach without documented prior express written consent. TCPA violations can carry penalties. You are solely responsible for compliance with TCPA, FDCPA, and DNC regulations. These flags are informational, not legal advice. Related endpoints: Get One DNC Job · DNC Scrub (v1) · DNC Scrub from a Trace (v1)

Fields

Responses