DNC Lookup (v1)

Synchronous DNC check. Send one phone object or an array of up to 15 phone objects and get back Federal DNC, State DNC, DMA, and TCPA Litigator flags 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 30 RPM per user. A v2 of this endpoint is available at POST /v2/api/dnc/lookup/, which names the matched state registries but drops dma and phone_type. v2 has its own 120-item-per-minute limit. See DNC API Versions. 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 /v1/api/dnc/scrub/ instead, it self-paces and isn't subject to this 30 RPM limit. Response fields: - national_dnc: on the Federal Do Not Call Registry - state_dnc: on a State DNC list - dma: on the Direct Marketing Association list - litigator: known TCPA litigator - phone_type: Mobile or Landline - is_clean: true only if no flags are set ⚠️ 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: Phone Verification · DNC Scrub · DNC Scrub from a Trace