---
title: "List peers"
method: GET
path: "/syncer/peers"
tags: ["syncer"]
---

# List peers

`GET /syncer/peers`

Returns a list of currently connected peers

## Response `200`

Current syncer peers.

- Peer[]
  - `address` string, required — Network address of the connected peer.
  - `inbound` boolean, required — Whether the peer initiated the connection.
  - `version` string, required — Protocol version reported by the peer.
  - `firstSeen` string, date-time, nullable — Time the peer was first seen.
  - `connectedSince` string, date-time, nullable — Time the current connection was established.
  - `syncedBlocks` integer, nullable — Number of blocks synced from this peer in the current session.
  - `syncDuration` integer, nullable — Total time spent syncing blocks from this peer in nanoseconds.

## Changes

- **2025-10-09** `9253c6f7b002` — 1 breaking
  - the `items/syncDuration` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
- **2025-10-08** `103993fc0091` — 1 breaking
  - the `items/syncDuration` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/syncer/peers/get.md)

---

[API](https://skmtc.dev/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/revisions/08ff756929fc/schema)