API Reference › Phone Verification & DNC

DNC Scrub from a Trace

POST /v2/api/dnc/scrub-from-queue/

Cost: 1 credit per phone checked, charged when the job finishes.

Rate limit: 10 scrubs per 5 minutes per account.

Mode: Async: returns a job ID, results arrive by download link and webhook.

Extract phone numbers from a completed trace queue and submit them for DNC scrubbing. Optionally specify which phone columns to include. Phones are deduplicated across all selected columns. 1 credit per phone checked. Valid phone_columns: primary_phone, mobile_1, mobile_2, mobile_3, mobile_4, mobile_5, landline_1, landline_2, landline_3 If phone_columns is omitted, all 9 phone fields are included by default. Related endpoints: DNC Lookup · Get One DNC Job · DNC Scrub (v1)

Fields

queue_id (required): ID of a completed trace queue to extract phones from.
phone_columns: List of phone field names to include. Defaults to all 9 phone fields.

Responses

200: Success.
400: Source trace still processing
402: Insufficient credits
404: Source trace queue not found
429: Rate limit reached: 10 scrubs per 5 minutes per account.