Litigator Scrub Single Number

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

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))

}

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
  }
]

GET

v1.5

Scrub

litigator

Litigator Scrub Single Number

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

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))

}

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

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 compatibility

Example 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 otherwise

Error 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 the loginId in the HTTP header rather than as a query parameter. This prevents your API key from appearing in server logs and browser history.

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Litigator Scrub Single Number

Request

Headers

Query Parameters

Example Request

Response Fields

Error Responses

Processing the Response

Security Best Practice

​Request

​Headers

​Query Parameters

​Example Request

​Response Fields

​Error Responses

​Processing the Response

​Security Best Practice

Request

Headers

Query Parameters

Example Request

Response Fields

Error Responses

Processing the Response

Security Best Practice