Get All Spam Scores

Retrieve carrier spam scores for all monitored phone numbers

GET /v1.5/TrustCall/GetAll

Get All Spam Scores

cURL

curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/TrustCall/GetAll \
  --header 'loginId: <loginid>'

Response

[
  {
    "Response": "Phone number current score",
    "Phone": "7867056421",
    "LegalEntityId": 123,
    "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",
    "LegalEntityId": 456,
    "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

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

Response

[
  {
    "Response": "Phone number current score",
    "Phone": "7867056421",
    "LegalEntityId": 123,
    "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",
    "LegalEntityId": 456,
    "CurrScore": "Clean",
    "MaxScore": "Clean",
    "HistoricalScore": "0",
    "VerizonScore": "Clean",
    "ATTScore": "Clean",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Clean",
    "FTCComplaints": null
  }
]

Response Headers

Header	Description
X-Total-Count	Total number of phone numbers in your account

Response Fields

Response · string

Status message

Phone · string

The phone number

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)

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

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