Get Spam Scores

Retrieve current carrier spam scores for monitored phone numbers

GET /v1.5/TrustCall/Get

Get Spam Scores

cURL

curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/TrustCall/Get \
  --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": "3862847537",
    "LegalEntityId": 456,
    "CurrScore": "Clean",
    "MaxScore": "Clean",
    "HistoricalScore": "0",
    "VerizonScore": "Clean",
    "ATTScore": "Clean",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Clean",
    "FTCComplaints": null
  }
]

Retrieve current carrier spam scores for specific phone numbers being monitored.

For checking scores of all monitored numbers at once, use the Get All endpoint instead.

Request

Headers

loginId · string · required

Your API Key (LoginId from your DNCScrub account)

Query Parameters

phoneList · string · required

Comma-separated list of 10-digit phone numbers (maximum 200 numbers)

Example Request

cURL

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/TrustCall/Get?phoneList=7867056421,3862847537' \
  --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": "3862847537",
    "LegalEntityId": 456,
    "CurrScore": "Clean",
    "MaxScore": "Clean",
    "HistoricalScore": "0",
    "VerizonScore": "Clean",
    "ATTScore": "Clean",
    "TMobileScore": "Clean",
    "RoboKillerStatus": "Clean",
    "NomoroboStatus": "Clean",
    "FTCComplaints": null
  }
]

Response Fields

Response · string

Status message

Phone · string

The phone number that was checked

LegalEntityId · integer

The legal entity identifier associated with the phone number

CurrScore · string

Current average carrier spam score:

• Clean - No spam flags
• Medium - Some carriers flagged
• High - Multiple carriers flagged
• Processing - Score check in progress

MaxScore · string

Maximum score recorded in the last 15 days

HistoricalScore · string

Historical score from 0-5:

• 0-1 - No significant 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 or Flagged

NomoroboStatus · string

Nomorobo app status: Clean or Flagged

FTCComplaints · array | null

Array of FTC complaints, or null if none. See FTC Complaint Fields below.

FTC Complaint Fields

FTCComplaintId · string

Unique complaint identifier

Phone · string

Phone number the complaint was filed against

CreatedDate · string

When the complaint was filed

ViolationDate · string

When the alleged violation occurred

City · string

Complainant’s city

State · string

Complainant’s state

AreaCode · string

Complainant’s area code

Subject · string

Complaint category/subject

RecordedMessageOrRobocall · string

Y if this was a robocall complaint

Error Responses

Status	Description
400 Bad Request	Invalid phone number format or missing parameters
401 Unauthorized	Invalid or missing API key

Limits

• Maximum 200 phone numbers per GET request
• For larger batches, use POST to /v1.5/TrustCall/Get with a JSON array body