Litigator Scrub Single Number
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/Scrub/litigator \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/Scrub/litigator"
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/Scrub/litigator', 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/Scrub/litigator",
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/Scrub/litigator"
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/Scrub/litigator")
.header("loginId", "<loginid>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dataapi.dncscrub.com/v1.5/Scrub/litigator")
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[
{
"Phone": 5039367187,
"IsLitigator": true
},
{
"Phone": 7075276405,
"IsLitigator": false
}
]
Litigator-Only Scrub
Litigator Scrub Single Number
Check phone numbers against the litigator database using GET request
GET
/
v1.5
/
Scrub
/
litigator
Litigator Scrub Single Number
curl --request GET \
--url https://dataapi.dncscrub.com/v1.5/Scrub/litigator \
--header 'loginId: <loginid>'import requests
url = "https://dataapi.dncscrub.com/v1.5/Scrub/litigator"
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/Scrub/litigator', 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/Scrub/litigator",
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/Scrub/litigator"
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/Scrub/litigator")
.header("loginId", "<loginid>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dataapi.dncscrub.com/v1.5/Scrub/litigator")
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[
{
"Phone": 5039367187,
"IsLitigator": true
},
{
"Phone": 7075276405,
"IsLitigator": false
}
]
Check a list of phone numbers against the litigator database using an HTTP GET request. Use this method for small batches (up to 100 phone numbers).
For batches larger than 100 phone numbers, use the POST
method instead.
Request
Headers
string
required
Your API Key (LoginId from your DNCScrub account)
Query Parameters
string
required
Comma-separated list of 10-digit phone numbers to check (maximum 100 numbers
for GET requests, up to 10,000 for POST)
integer
Optional campaign ID for tracking purposes
string
Optional project ID for tracking purposes
string
default:"JsonArray"
Output format:
JsonArray (default) or JsonObject for Zapier compatibilityExample Request
curl --location --request GET \
'https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405' \
--header 'loginId: YOUR_API_KEY'
curl --location --request GET \
'https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405&loginId=YOUR_API_KEY'
const response = await fetch(
"https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405",
{
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 phoneNumbers = "5039367187,7075276405";
var url = $"https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList={phoneNumbers}";
var response = await client.GetStringAsync(url);
Console.WriteLine(response);
}
[
{
"Phone": 5039367187,
"IsLitigator": true
},
{
"Phone": 7075276405,
"IsLitigator": false
}
]
Response Fields
integer
The 10-digit phone number that was checked
boolean
true if the phone number is associated with a known TCPA litigator, false
otherwiseError Responses
| Status | Description |
|---|---|
| 400 Bad Request | Invalid phone number format or missing required parameters |
| 401 Unauthorized | Invalid or missing API key |
| 404 Not Found | Endpoint not found or invalid URL |
Processing the Response
const results = await response.json();
// Filter litigator numbers
const litigators = results.filter((r) => r.IsLitigator);
const safe = results.filter((r) => !r.IsLitigator);
console.log(`Litigators found: ${litigators.length}`);
console.log(`Safe numbers: ${safe.length}`);
// Flag litigator numbers
litigators.forEach((r) => {
console.log(`WARNING: ${r.Phone} is a known litigator`);
});
Security Best Practice
For additional security, pass theloginId in the HTTP header rather than as a query parameter. This prevents your API key from appearing in server logs and browser history.