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

# Flags Removed Summary

> Retrieve a summary of spam flags removed across carriers within a specified time period

Retrieve a summary of spam flags that have been removed across carriers within a specified time period. This endpoint provides counts of flags removed for AT\&T, Rogers/Bell, T-Mobile, Verizon, and Total flags removed.

## Request

### Headers

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

### Query Parameters

<ParamField query="days" type="integer" default="7">
  Number of days to look back. Minimum is 1, maximum is 90. Defaults to 7.
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.5/TrustCall/FlagsRemovedSummary?days=30' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.5/TrustCall/FlagsRemovedSummary?days=30',
    {
      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 response = await client.GetAsync(
          "https://dataapi.dncscrub.com/v1.5/TrustCall/FlagsRemovedSummary?days=30"
      );

      var result = await response.Content.ReadAsStringAsync();
      Console.WriteLine(result);
  }
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "Att": 5,
    "Tmobile": 12,
    "Verizon": 8,
    "RogersBell": 0,
    "Total": 25
  }
  ```
</ResponseExample>

## Response Fields

<ResponseField name="Att" type="integer">
  Number of AT\&T flags removed in the specified period. For Canadian accounts, this will be `0`.
</ResponseField>

<ResponseField name="Tmobile" type="integer">
  Number of T-Mobile flags removed in the specified period
</ResponseField>

<ResponseField name="Verizon" type="integer">
  Number of Verizon flags removed in the specified period
</ResponseField>

<ResponseField name="RogersBell" type="integer">
  Number of Rogers/Bell flags removed in the specified period. For US accounts, this will be `0`.
</ResponseField>

<ResponseField name="Total" type="integer">
  Total number of flags removed across all supported carriers in the specified period
</ResponseField>

## Error Responses

| Status           | Description                                         |
| ---------------- | --------------------------------------------------- |
| 400 Bad Request  | Invalid `days` parameter (must be between 1 and 90) |
| 401 Unauthorized | Invalid or missing API key                          |