Skip to main content
GET
/
app
/
main
/
rpc
/
pdnc
Internal DNC List
curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/pdnc \
  --header 'loginId: <loginid>'
{
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt

Use this file to discover all available pages before exploring further.

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 --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/pdnc?phoneList=5039367187&actionType=add' \
  --header 'loginId: YOUR_API_KEY'

{
  "success": true
}

​
Response

Status CodeMeaning
200Success - Operation completed (no response body for add/remove)
4xxError - 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

Always validate that phone numbers are exactly 10 digits before making the API call.
Adding a number that already exists won’t cause an error - it simply has no effect (idempotent).
Removing a number that doesn’t exist has no effect and won’t cause an error.
If you have multiple campaigns or clients, use the projId parameter to organize your IDNC lists.