> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Litigator Scrub Single Number

> Check phone numbers against the litigator database using GET request

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

<Note>
  For batches larger than 100 phone numbers, use the [POST
  method](/api-reference/litigator/scrub-post) instead.
</Note>

## Request

### Headers

<ParamField header="loginId" type="string" required>
  Your API Key (LoginId from your DNCScrub account)
</ParamField>

### Query Parameters

<ParamField query="phoneList" type="string" required>
  Comma-separated list of 10-digit phone numbers to check (maximum 100 numbers
  for GET requests, up to 10,000 for POST)
</ParamField>

<ParamField query="campaignId" type="integer">
  Optional campaign ID for tracking purposes
</ParamField>

<ParamField query="projId" type="string">
  Optional project ID for tracking purposes
</ParamField>

<ParamField query="outputFormat" type="string" default="JsonArray">
  Output format: `JsonArray` (default) or `JsonObject` for Zapier compatibility
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```bash cURL (loginId in query) theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.5/Scrub/litigator?phoneList=5039367187,7075276405&loginId=YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  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);
  ```

  ```csharp C# theme={null}
  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);
  }
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "Phone": 5039367187,
      "IsLitigator": true
    },
    {
      "Phone": 7075276405,
      "IsLitigator": false
    }
  ]
  ```
</ResponseExample>

## Response Fields

<ResponseField name="Phone" type="integer">
  The 10-digit phone number that was checked
</ResponseField>

<ResponseField name="IsLitigator" type="boolean">
  `true` if the phone number is associated with a known TCPA litigator, `false`
  otherwise
</ResponseField>

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

```javascript theme={null}
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.