Skip to main content
GET
https://www.dncscrub.com
/
app
/
main
/
rpc
/
pdnc
Internal DNC List
curl --request GET \
  --url https://www.dncscrub.com/app/main/rpc/pdnc \
  --header 'loginId: <loginid>'
{
  "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.

​
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

​
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.