# apex trace list

List trace flags in your org.

## Description for apex trace list

Display a list of active and recently expired trace flags in your org org. Trace flags control debug logging for a specific user, Apex class, or Apex trigger. Use the "apex trace create" CLI command to create a trace flag.

## Flags

| Flag Name (Long) | Flag Name (Short) | Description                                                                                                                                         |
| ---------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-version`  | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                          |
| `--flags-dir`    | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                         |
| `--json`         | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                     |
| `--target-org`   | `-o`              | **Type:** Value<br>**Required**<br><br>Username or alias of the target org. Not required if the `target-org` configuration variable is already set. |

## Examples for apex trace list

List all trace flags in your default org:

```shell
sf apex trace list
```

List trace flags for an org with alias "my-org":

```shell
sf apex trace list --target-org my-org
```