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

# Usage Statistics

> Retrieves usage statistics for verification or residential/business lookups within a date range.

## Request

### Headers

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

### Query Parameters

<ParamField query="type" type="string" required>
  The type of usage to retrieve: `verification` or `ResOrBusiness`
</ParamField>

<ParamField query="startDate" type="string" required>
  Start date in YYYYMMDD format
</ParamField>

<ParamField query="endDate" type="string" required>
  End date in YYYYMMDD format
</ParamField>

## Output parameters

| Field     | Description                                |
| --------- | ------------------------------------------ |
| `Status`  | The status or category of the usage record |
| `Request` | The count of requests for this status      |

### Status values

When `type` is `verification`, the `Status` field contains the verification category (CategoryPhoneMatch).

When `type` is `ResOrBusiness`, the `Status` field contains the record type:

| Value | Description                                             |
| ----- | ------------------------------------------------------- |
| `R`   | Residential                                             |
| `B`   | Business                                                |
| `U`   | Unknown. The record type was not able to be determined. |

## Example Request #1 (Verification)

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.4/Data/Usage
      ?startDate=20260101
      &endDate=20260131
      &type=verification' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.4/Data/Usage?startDate=20260101&endDate=20260131&type=verification',
    {
      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.4/Data/Usage?startDate=20260101&endDate=20260131&type=verification"
      );

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

## Example Request #2 (ResOrBusiness)

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.4/Data/Usage
      ?startDate=20260101
      &endDate=20260131
      &type=ResOrBusiness' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.4/Data/Usage?startDate=20260101&endDate=20260131&type=ResOrBusiness',
    {
      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.4/Data/Usage?startDate=20260101&endDate=20260131&type=ResOrBusiness"
      );

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

<ResponseExample>
  ```json Response (Verification) theme={null}
  [
    {
      "Status": "Y",
      "Request": 8038
    },
    {
      "Status": "L",
      "Request": 1242
    },
    {
      "Status": "U",
      "Request": 4389
    },
    {
      "Status": "YX",
      "Request": 2703
    },
    {
      "Status": "YP",
      "Request": 3696
    },
    {
      "Status": "N",
      "Request": 940
    },
    {
      "Status": "",
      "Request": 23
    },
    {
      "Status": "V",
      "Request": 3
    },
    {
      "Status": "YP*",
      "Request": 1
    }
  ]
  ```

  ```json Response (ResOrBusiness) theme={null}
  [
    {
      "Status": "R",
      "Request": 69591
    },
    {
      "Status": "B",
      "Request": 11772
    },
    {
      "Status": "U",
      "Request": 6108
    }
  ]
  ```
</ResponseExample>