Add Phone Numbers

Add phone numbers to TrustCall monitoring for automatic spam score checks

POST /v1.5/TrustCall/Add

Add Phone Numbers

cURL

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>",
  "LegalEntityId": 123
}
'

Response

[
  {
    "Response": "Phone number added to monitor",
    "Phone": "5039367187",
    "LegalEntityId": 123,
    "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",
    "LegalEntityId": 456,
    "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

Service type for the phone number. If omitted, defaults to Remediation for accounts with remediation service enabled, or Scanning for all other accounts.

Valid values:

Value	Description
Scanning	Standard monitoring service
Remediation	Remediation service
Remediation Daily Scans	Remediation with daily scanning

If an unrecognized value is provided, the item’s Response field returns Invalid Service type (HTTP status remains 200).

LegalEntityId · integer

Optional legal entity identifier

Example Request

cURL

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", "LegalEntityId": 123 },
    { "Phone": "8084565302", "Label": "Marketing", "LegalEntityId": 456 }
  ]'

Response

[
  {
    "Response": "Phone number added to monitor",
    "Phone": "5039367187",
    "LegalEntityId": 123,
    "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",
    "LegalEntityId": 456,
    "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

LegalEntityId · integer

The legal entity identifier associated with the phone number

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

Status	Description
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