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
phone (required): 10-digit US phone number. Formatting is stripped automatically (dashes, spaces, parentheses, leading 1).
Responses
200: Flagged: not clean
400: Missing or invalid phone: No phone in body
402: Insufficient credits
429: Rate limit reached: 120 lookups per minute per account. Each array item counts as one.
502: Upstream temporarily unavailable
503: DNC lookup not configured on this server