---
title: "List known peers"
method: GET
path: "/api/v1/admin/peers"
tags: ["Admin", "Peer"]
---

# List known peers

`GET /api/v1/admin/peers`

List all peers known in the system, and info about their connection.
This includes the endpoint, how we know about the peer, the connection state, and if the connection is alive the amount
of bytes we've sent to and received from the peer.

## Response `200`

Success

- PeerStats[]
  - `endpoint` Endpoint — Identification to connect to a peer
    - `proto` 'tcp' | 'quic' — Protocol used
    - `socketAddr` string — The socket address used
  - `type` 'static' | 'inbound' | 'linkLocalDiscovery' — How we know about this peer
  - `connectionState` 'alive' | 'connecting' | 'dead' — The current state of the connection to the peer
  - `txBytes` integer — The amount of bytes transmitted to this peer
  - `rxBytes` integer — The amount of bytes received from this peer

---

[API](https://skmtc.net/threefoldtech/apis/mycelium-management.md) · [All operations](https://skmtc.net/threefoldtech/apis/mycelium-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/threefoldtech/mycelium-management/versions/65042c1a7b84/schema)