---
layout: commands
page_title: 'Commands: Peering List'
description: |
  The `consul peering lists` command outputs a list of the local cluster's cluster peering connections, including imported and exported service counts and the connection state.
---

# Consul Peering List

Command: `consul peering List`

Corresponding HTTP API Endpoint: [\[GET\] /v1/peerings](/consul/api-docs/peering#list-all-peerings)

The `peering list` lists all peering connections.
The results are filtered according to ACL policy configuration.

The table below shows this command's [required ACLs](/consul/api-docs/api-structure#authentication).

| ACL Required |
| ------------ |
| `peering:read`  |

## Usage

Usage: `consul peering list [options]`

#### Command Options

- `-format={pretty|json}` - Command output format. The default value is `pretty`.

#### Enterprise Options

@include 'legacy/cli-http-api-partition-options.mdx'

#### API Options

@include 'legacy/http_api_options_client.mdx'

## Examples

The following example lists all peering connections associated with the cluster:

```shell-session hideClipboard
$ consul peering list
Name        State    Imported Svcs  Exported Svcs  Meta
cluster-02  ACTIVE   0              2              env=production
cluster-03  PENDING  0              0
```

