Internal DNC List

Add or remove phone numbers from your Internal DNC list

GET /app/main/rpc/pdnc

Internal DNC List

cURL

curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/pdnc \
  --header 'loginId: <loginid>'

Response (Success)

{
  "success": true
}

Manage your Internal Do Not Call (IDNC) list programmatically. The IDNC list is your organization’s private DNC database, separate from national and state DNC lists.

Request

Headers

loginId · string · required

Your API Key

Query Parameters

phoneList · string · required

The 10-digit phone number(s) to add or remove. For multiple numbers, comma-separate them (e.g., 5039367187,7075276405)

actionType · string · required

Action to perform: - add - Add numbers to Internal DNC list - remove - Remove numbers from Internal DNC list - count - Get the count of numbers in your IDNC database - status - Check if a number is on your Internal DNC list

projId · string

Optional Project ID of the Internal DNC list.

ignoreInvalid · boolean · default: "false"

Only applies to actionType=add. Controls behavior when the request contains an invalid phone number:

• 0 / false (default) - Abort the entire import on the first invalid number. No numbers are added and a 4xx error is returned.
• 1 / true - Skip invalid numbers and import the valid ones.

Example Request

cURL (Add)

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=5039367187&actionType=add' \
  --header 'loginId: YOUR_API_KEY'

Response (Success)

{
  "success": true
}

Response

Status Code	Meaning
200	Success - Operation completed (no response body for add/remove)
4xx	Error - Response body contains error message

Multiple Phone Numbers

Add or remove multiple phone numbers by comma-separating them:

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=5039367187,7075276405,7072842774&actionType=add' \
  --header 'loginId: YOUR_API_KEY'

Add to Specific Project

To add a phone number to a specific project’s IDNC list:

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=5039367187&actionType=add&projId=YOUR_PROJECT_ID' \
  --header 'loginId: YOUR_API_KEY'

Error Handling

If you pass an invalid phone number, the API returns an error:

Request:

https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=BADNUMBER&actionType=add

Response (HTTP 4xx):

Error importing or updating phone numbers. Check that the numbers are of a probable format: BADNUMBER

Skipping Invalid Numbers

By default, a single bad number aborts the entire add request. To import the valid numbers and silently skip invalid ones, pass ignoreInvalid=1:

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=5039367187,BADNUMBER,7075276405&actionType=add&ignoreInvalid=1' \
  --header 'loginId: YOUR_API_KEY'

The two valid numbers are added; BADNUMBER is skipped.

Best Practices

Validate Before Adding

Always validate that phone numbers are exactly 10 digits before making the API call.

Handle Duplicates

Adding a number that already exists won’t cause an error - it simply has no effect (idempotent).

Removing Non-Existent Numbers

Removing a number that doesn’t exist has no effect and won’t cause an error.

Use Projects

If you have multiple campaigns or clients, use the projId parameter to organize your IDNC lists.