# uip rules list

> Syntax and options for `uip rules list`, which lists the business rules deployed to one Orchestrator folder or to every folder you can access.

:::note
`uip rules list` is labeled Preview in the command help. Refer to [Versioning](./versioning.md#per-command-stability) for what the Preview label means.
:::

`uip rules list` lists the business rules deployed to an Orchestrator folder. Each row returns the rule's key, name, folder, description, and current version. An empty folder returns `Data: []`.

With `--all-folders`, the command lists the business rules in every folder you can access, from the resource catalog of the tenant you are logged in to. It returns one row per folder a rule is shared to, and the rows have no `CurrentVersion`, because the catalog carries no version.

## Synopsis

```
uip rules list (--folder-path <path> | --folder-key <key> | --all-folders) [-l <number>] [--offset <number>]
```

## Options

Pass exactly one of `--folder-path`, `--folder-key`, or `--all-folders`.

| Short | Long | Value | Default | Description |
|---|---|---|---|---|
| | `--folder-path` | string | — | Folder path, for example `Shared`. |
| | `--folder-key` | GUID | — | Folder key. |
| | `--all-folders` | flag | — | List business rules across every folder you can access. Cannot be combined with `--folder-path` or `--folder-key`. |
| `-l` | `--limit` | integer (1–10000) | `50` | Number of rules to return. |
| | `--offset` | integer | `0` | Number of rules to skip. |

## Examples

```bash
uip rules list --folder-path "Shared" --limit 1

# One row per folder a rule is shared to, across every folder you can access
uip rules list --all-folders
```

## Data shape (--output json)

```json
{
  "Code": "RulesList",
  "Data": [
    {
      "Key": "3f1c2a9e-8b4d-4e2a-9c1f-6d7e8f9a0b1c",
      "Name": "LoanEligibility",
      "FolderPath": "Shared",
      "FolderKey": "9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e",
      "Description": "Decides loan eligibility",
      "CurrentVersion": "1.0.2"
    }
  ]
}
```

The envelope also carries a `Pagination` object with `Returned`, `Limit`, `Offset`, and `HasMore`.

## Exit codes

Refer to [Exit codes](./exit-codes.md) for the shared contract. The command exits `1` with `ErrorCode: "invalid_argument"` when no folder selector or more than one is passed.

## Related commands

- [`uip rules get`](./uip-rules-get.md) gets one rule by name.
- [`uip or folders list`](./uip-or-folders.md#uip-or-folders-list) finds folder paths and keys.

## See also

- [`uip rules`](./uip-rules.md) for the tool overview.
