Get Spam Scores

Get Spam Scores

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

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://dataapi.dncscrub.com/v1.5/TrustCall/Get', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dataapi.dncscrub.com/v1.5/TrustCall/Get",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dataapi.dncscrub.com/v1.5/TrustCall/Get"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dataapi.dncscrub.com/v1.5/TrustCall/Get")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

[
  {
    "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
  }
]

GET

v1.5

TrustCall

Get

Get Spam Scores

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

const options = {method: 'GET', headers: {loginId: '<loginid>'}};

fetch('https://dataapi.dncscrub.com/v1.5/TrustCall/Get', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dataapi.dncscrub.com/v1.5/TrustCall/Get",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dataapi.dncscrub.com/v1.5/TrustCall/Get"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dataapi.dncscrub.com/v1.5/TrustCall/Get")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

[
  {
    "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

Your API Key (LoginId from your DNCScrub account)

Query Parameters

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'

const response = await fetch(
  'https://dataapi.dncscrub.com/v1.5/TrustCall/Get?phoneList=7867056421,3862847537',
  {
    method: 'GET',
    headers: { 'loginId': 'YOUR_API_KEY' }
  }
);
const data = await response.json();
console.log(data);

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

    var url = "https://dataapi.dncscrub.com/v1.5/TrustCall/Get?phoneList=7867056421,3862847537";
    var response = await client.GetStringAsync(url);
    Console.WriteLine(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

string

Status message

string

The phone number that was checked

integer

The legal entity identifier associated with the phone number

string

Current average carrier spam score:

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

string

Maximum score recorded in the last 15 days

string

Historical score from 0-5:

0-1 - No significant issues
5 - 50%+ high spam history

string

Verizon carrier status: Clean, Flagged, or Processing

string

AT&T carrier status: Clean, Flagged, or Processing

string

T-Mobile carrier status: Clean, Flagged, or Processing

string

RoboKiller app status: Clean or Flagged

string

Nomorobo app status: Clean or Flagged

array | null

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

FTC Complaint Fields

string

Unique complaint identifier

string

Phone number the complaint was filed against

string

When the complaint was filed

string

When the alleged violation occurred

string

Complainant’s city

string

Complainant’s state

string

Complainant’s area code

string

Complaint category/subject

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

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Request

Headers

Query Parameters

Example Request

Response Fields

FTC Complaint Fields

Error Responses

Limits

​Request

​Headers

​Query Parameters

​Example Request

​Response Fields

​FTC Complaint Fields

​Error Responses

​Limits

Request

Headers

Query Parameters

Example Request

Response Fields

FTC Complaint Fields

Error Responses

Limits