---
title: "The CLI purge status command"
slug: "the-cli-purge-status-command"
abstract: "Reference of the xConnect DevEx CLI status command that checks the progress of purge tasks."
---
# The CLI purge status command

The [xConnect DevEx CLI plugin](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-platform/xconnect-devex-cli-plugin.html "xConnect DevEx CLI plugin") includes a `status` subcommand. This command checks the progress of a [registered](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-platform/the-cli-purge-contacts-command.html "The CLI purge contacts command") purge task.

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

You can use the command as follows:

```text
sitecore xconnect purge status [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. |
| `--pti, --processing-task-id` | Yes | The unique identifier of the ongoing purge task. |
| `-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>