---
title: "The CLI estimate contacts command"
slug: "the-cli-estimate-contacts-command"
abstract: "Describes the xConnect DevEx CLI estimate contacts command that estimates the number of contacts deleted in a purge."
---
# The CLI estimate contacts command

The [xConnect DevEx CLI plugin](https://doc.sitecore.com/xp/en/developers/102/sitecore-experience-platform/xconnect-devex-cli-plugin.html "xConnect DevEx CLI plugin") includes an `estimate` command with a `contacts` subcommand. This command estimates the number of contacts a purge process would delete based on the provided `CutoffDays` and other options.

<details>
<summary><h2>Usage</h2></summary>

You can use the command as follows:

```text
sitecore xconnect estimate contacts [options]

```

</details>

<details>
<summary><h2>Options</h2></summary>

You can use the following options with the command:

| Option | Required? | Description |
| --- | --- | --- |
| `-c, --config` | Yes | The path to the `sitecore.json` configuration file (default: cwd). A DevEx CLI standard option. |
| `-n, --environment-name` | Yes | The Sitecore environment to use. Default: `default`. A DevEx CLI standard option. |
| `-d, --cutoffdays` | Yes | The number of days the contact has not interacted with the brand. For example, `-d 190`.<br><br>> [!note]<br>> This option is the only requirement with no default value.<br><br>There is a list of restrictions for the `cutoffdays` option:<br><br><ul><li>The minimum available value is 180 days by default (see [Configure the Cortex Processing Engine for task registration](https://doc.sitecore.com/xp/en/developers/102/sitecore-experience-platform/configure-the-cortex-processing-engine-for-task-registration.html)).</li><li>The value must be a positive integer.</li></ul> |
| `--sp, --start-percentile` | No | The range-bound start percentile for the data extraction. For example, `--sp 0`.<br><br>There is a list of restrictions for the `start-percentile` option:<br><br><ul><li>You must specify both the start and end percentile or none of them.</li><li>The range-bound for both is between 0 and 1.</li><li>The `start-percentile` must be lower than the `end-percentile`.</li></ul> |
| `--ep, --end-percentile` | No | The range-bound end percentile for data extraction. For example, `--ep 1`.<br><br>There is a list of restrictions for the `end-percentile` option:<br><br><ul><li>You must specify both the start and end percentile or none of them.</li><li>The range-bound for both is between 0 and 1.</li><li>The `end-percentile` must be higher than the `start-percentile`.</li></ul> |
| `-v, --verbose` | No | Report additional diagnostic and performance data. |
| `-t, --trace` | No | Report additional diagnostic and performance data. |
| `-?, -h, --help` | No | Help for the command. |

</details>

<details>
<summary><h2>Examples</h2></summary>

The following are examples of the `estimate contacts` command use:

```

sitecore xconnect estimate contacts -d 180

sitecore xconnect estimate contacts -d 200 --sp 0.3 --ep 0.5 -n test --trace --verbose

```

</details>