Skip to main content
POST
https://dataapi.dncscrub.com
/
v1.5
/
TrustCall
/
Add
Add Phone Numbers
curl --request POST \
  --url https://dataapi.dncscrub.com/v1.5/TrustCall/Add \
  --header 'Content-Type: <content-type>' \
  --header 'loginId: <loginid>' \
  --data '
{
  "Phone": "<string>",
  "Label": "<string>",
  "ServiceType": "<string>"
}
'
[
  {
    "Response": "Phone number added to monitor",
    "Phone": "5039367187",
    "CurrScore": "Processing",
    "MaxScore": "Processing",
    "HistoricalScore": "0",
    "VerizonScore": "Processing",
    "ATTScore": "Processing",
    "TMobileScore": "Processing",
    "RoboKillerStatus": "Processing",
    "NomoroboStatus": "Processing",
    "FTCComplaints": null
  },
  {
    "Response": "Phone number added to monitor",
    "Phone": "8084565302",
    "CurrScore": "Processing",
    "MaxScore": "Processing",
    "HistoricalScore": "0",
    "VerizonScore": "Processing",
    "ATTScore": "Processing",
    "TMobileScore": "Processing",
    "RoboKillerStatus": "Processing",
    "NomoroboStatus": "Processing",
    "FTCComplaints": null
  }
]
Add phone numbers to TrustCall monitoring. Numbers will be automatically checked for carrier spam scores.
When first added, scores may show as Processing until checked with each carrier (typically within 24 hours).

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)
​
Content-Type
string
required
Must be application/json

​
Request Body

The request body is a JSON array of phone number objects:
​
Phone
string
required
10-digit North American phone number (without leading 1 or +)
​
Label
string
Optional description or label for the phone number (max 50 characters)
​
ServiceType
string
Optional service type identifier

​
Example Request

curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/TrustCall/Add' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '[
    { "Phone": "5039367187", "Label": "Customer Service" },
    { "Phone": "8084565302", "Label": "Marketing" }
  ]'

[
  {
    "Response": "Phone number added to monitor",
    "Phone": "5039367187",
    "CurrScore": "Processing",
    "MaxScore": "Processing",
    "HistoricalScore": "0",
    "VerizonScore": "Processing",
    "ATTScore": "Processing",
    "TMobileScore": "Processing",
    "RoboKillerStatus": "Processing",
    "NomoroboStatus": "Processing",
    "FTCComplaints": null
  },
  {
    "Response": "Phone number added to monitor",
    "Phone": "8084565302",
    "CurrScore": "Processing",
    "MaxScore": "Processing",
    "HistoricalScore": "0",
    "VerizonScore": "Processing",
    "ATTScore": "Processing",
    "TMobileScore": "Processing",
    "RoboKillerStatus": "Processing",
    "NomoroboStatus": "Processing",
    "FTCComplaints": null
  }
]

​
Response Fields

​
Response
string
Status message indicating the result of the add operation
​
Phone
string
The phone number that was added
​
CurrScore
string
Current average carrier spam score: Clean, Medium, High, or Processing
​
MaxScore
string
Maximum score recorded in the last 15 days
​
HistoricalScore
string
Historical score from 0-5 (0-1 = no issues, 5 = 50%+ high spam history)
​
VerizonScore
string
Verizon carrier status: Clean, Flagged, or Processing
​
ATTScore
string
AT&T carrier status: Clean, Flagged, or Processing
​
TMobileScore
string
T-Mobile carrier status: Clean, Flagged, or Processing
​
RoboKillerStatus
string
RoboKiller app status: Clean, Flagged, or Processing
​
NomoroboStatus
string
Nomorobo app status: Clean, Flagged, or Processing
​
FTCComplaints
array | null
Array of FTC complaints associated with the number, or null if none

​
Error Responses

​
400 Bad Request
Invalid request body or phone number format
​
401 Unauthorized
Invalid or missing API key

​
Limits

  • Maximum 50 phone numbers per add request