API Reference › Phone Verification & DNC

DNC Scrub (v1)

POST /v1/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

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 Federal DNC, State DNC, DMA, and TCPA Litigator databases. 1 credit per phone checked. A v2 of this endpoint is available at POST /v2/api/dnc/scrub/ and is recommended for new integrations. Same parameters, same price; see DNC API Versions. 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 Related endpoints: DNC Scrub from a Trace (v1) · DNC Lookup (v1) · Phone Verification

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.