API Reference › Phone Verification & DNC

DNC Scrub

POST /v2/api/dnc/scrub/

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.

Submit a phone list for DNC (Do Not Call) scrubbing. Upload a CSV with one or more phone columns, or pass a JSON array of phone numbers directly. Each phone is checked against the Federal DNC registry, state DNC registries, and known TCPA litigator records. 1 credit per phone checked. See DNC API Versions for the result fields. Input options (pick one): - CSV with single column: csv_file + phone_column (string) - CSV with multiple columns: csv_file + phone_columns (array), phones are merged & deduplicated - JSON phone list: phones array via application/json Result CSV columns: phone, label, national_dnc, state_dnc, state_dnc_list, litigator, is_clean. Related endpoints: DNC Scrub from a Trace · DNC Lookup · Get One DNC Job

Fields

csv_file: CSV file containing phone numbers. Required for Options 1 & 2. Do not send with phones.
phone_column: Single column name containing phone numbers (Option 1). Internally normalized to phone_columns. Mutually exclusive with phone_columns.
phone_columns: List of column names containing phone numbers (Option 2). Phones are merged & deduplicated. When multiple columns are used, labels are prefixed with the column name, e.g. '(Phone_1) John Doe'. Mutually exclusive with phone_column.
label_column: Single column to label each phone (e.g., name). Internally normalized to label_columns. Mutually exclusive with label_columns.
label_columns: List of columns to combine as a label for each phone (e.g., ["address", "city", "state"]). Values are joined with commas. When using multiple phone_columns, labels are also prefixed with the column name.
phones: Direct list of phone numbers via JSON body (Option 3). Do not send with csv_file.

Responses

200: Success.
400: Phone column not found in your CSV
402: Insufficient credits
403: Account suspended (unpaid invoices)
429: Rate limit reached: 10 scrubs per 5 minutes per account.