API Reference › Phone Verification & DNC
DNC Scrub from a Trace (v1)
POST /v1/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
Extract phone numbers from a completed trace queue from your skip tracing results 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.
A v2 of this endpoint is available at POST /v2/api/dnc/scrub-from-queue/. Same parameters, same price; see DNC API Versions.
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 (v1) · Phone Verification · DNC Scrub
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 processing402: Insufficient credits404: Source trace queue not found429: Rate limit reached: 10 scrubs per 5 minutes per account.