Get Spam Scores
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/TrustCall/Get \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/TrustCall/Get"
headers = {"loginId": "<loginid>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://dataapi.dncscrub.com/v1.5/TrustCall/Get")
.header("loginId", "<loginid>")
.asString();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
}
]
Call Deliverability (TrustCall)
Get Spam Scores
Retrieve current carrier spam scores for monitored phone numbers
GET
/
v1.5
/
TrustCall
/
Get
Get Spam Scores
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/TrustCall/Get \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/TrustCall/Get"
headers = {"loginId": "<loginid>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://dataapi.dncscrub.com/v1.5/TrustCall/Get")
.header("loginId", "<loginid>")
.asString();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
Query Parameters
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
Current average carrier spam score:
Clean- No spam flagsMedium- Some carriers flaggedHigh- Multiple carriers flaggedProcessing- Score check in progress
FTC Complaint Fields
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/Getwith a JSON array body