Skip to main content
GET
https://dataapi.dncscrub.com
/
v1.5
/
TrustCall
/
Get
Get Spam Scores
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.5/TrustCall/Get \
  --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": "3862847537",
    "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 --location --request GET \
  'https://dataapi.dncscrub.com/v1.5/TrustCall/Get?phoneList=7867056421,3862847537' \
  --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": "3862847537",
    "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
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

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