Skip to main content
GET
https://dataapi.dncscrub.com
/
v1.5
/
TrustCall
/
GetAll
Get All Spam Scores
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/TrustCall/GetAll \
  --header 'loginId: <loginid>'
[
  {
    "Response": "Phone number current score",
    "Phone": "7867056421",
    "CurrScore": "High",
    "MaxScore": "High",
    "HistoricalScore": "5",
    "VerizonScore": "Flagged",
    "ATTScore": "Flagged",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Flagged",
    "FTCComplaints": [
      {
        "FTCComplaintId": "79923e06b1c74d47e6ad5826b7554046",
        "Phone": "7867056421",
        "CreatedDate": "08/15/2022 22:22:39",
        "ViolationDate": "07/29/2022 12:04:00",
        "City": "Jackson",
        "State": "New Jersey",
        "AreaCode": "732",
        "Subject": "Dropped call or no message",
        "RecordedMessageOrRobocall": "Y"
      }
    ]
  },
  {
    "Response": "Phone number current score",
    "Phone": "5039367187",
    "CurrScore": "Clean",
    "MaxScore": "Clean",
    "HistoricalScore": "0",
    "VerizonScore": "Clean",
    "ATTScore": "Clean",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Clean",
    "FTCComplaints": null
  }
]
Retrieve carrier spam scores for all phone numbers being monitored by your account.
The X-Total-Count response header contains the total number of phone numbers in your account.

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)

​
Query Parameters

​
maxRecords
integer
default:"15000"
Maximum number of records to return. Defaults to 15,000.

​
Example Request

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/TrustCall/GetAll' \
  --header 'loginId: YOUR_API_KEY'

[
  {
    "Response": "Phone number current score",
    "Phone": "7867056421",
    "CurrScore": "High",
    "MaxScore": "High",
    "HistoricalScore": "5",
    "VerizonScore": "Flagged",
    "ATTScore": "Flagged",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Flagged",
    "FTCComplaints": [
      {
        "FTCComplaintId": "79923e06b1c74d47e6ad5826b7554046",
        "Phone": "7867056421",
        "CreatedDate": "08/15/2022 22:22:39",
        "ViolationDate": "07/29/2022 12:04:00",
        "City": "Jackson",
        "State": "New Jersey",
        "AreaCode": "732",
        "Subject": "Dropped call or no message",
        "RecordedMessageOrRobocall": "Y"
      }
    ]
  },
  {
    "Response": "Phone number current score",
    "Phone": "5039367187",
    "CurrScore": "Clean",
    "MaxScore": "Clean",
    "HistoricalScore": "0",
    "VerizonScore": "Clean",
    "ATTScore": "Clean",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Clean",
    "FTCComplaints": null
  }
]

​
Response Headers

HeaderDescription
X-Total-CountTotal number of phone numbers in your account

​
Response Fields

​
Response
string
Status message
​
Phone
string
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)
​
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 or Flagged
​
NomoroboStatus
string
Nomorobo app status: Clean or Flagged
​
FTCComplaints
array | null
Array of FTC complaints, or null if none

​
Error Responses

​
400 Bad Request
Invalid request parameters
​
401 Unauthorized
Invalid or missing API key
​
413 Payload Too Large
Too many records requested

​
Pagination Example

async function getAllMonitoredNumbers(apiKey) {
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.5/TrustCall/GetAll?maxRecords=15000',
    {
      headers: { 'loginId': apiKey }
    }
  );

  const totalCount = parseInt(response.headers.get('X-Total-Count'));
  const results = await response.json();

  console.log(`Retrieved ${results.length} of ${totalCount} total numbers`);

  // Categorize by score
  const flagged = results.filter(r => r.CurrScore === 'High');
  const medium = results.filter(r => r.CurrScore === 'Medium');
  const clean = results.filter(r => r.CurrScore === 'Clean');

  return {
    total: totalCount,
    flagged: flagged.length,
    medium: medium.length,
    clean: clean.length,
    results
  };
}