---
title: "Get the current peer registry."
method: GET
path: "/api/v1/peers"
tags: ["peers"]
---

# Get the current peer registry.

`GET /api/v1/peers`

Returns connection status, catchup metrics, and reputation scores.

## Response `200`

Peers list

- PeersResponse
  - `count` integer
  - `peers` PeerInfoResponse[]
    - `ban_score` integer
    - `block_hash` string
    - `bytes_received` integer
    - `catchup_attempts` integer — Catchup metrics
    - `catchup_avg_response_ms` integer
    - `catchup_failures` integer
    - `catchup_last_attempt` integer
    - `catchup_last_failure` integer
    - `catchup_last_success` integer
    - `catchup_malicious_count` integer
    - `catchup_reputation_score` number, double
    - `catchup_successes` integer
    - `client_name` string
    - `connected_at` integer
    - `data_hub_url` string
    - `height` integer
    - `id` string
    - `is_banned` boolean
    - `is_connected` boolean
    - `last_block_time` integer
    - `last_catchup_error` string
    - `last_catchup_error_time` integer
    - `last_message_time` integer

## Other responses

- `500` — Error response
- `503` — Error response

---

[API](https://skmtc.net/bsv-blockchain/apis/teranode-asset-service-api.md) · [All operations](https://skmtc.net/bsv-blockchain/apis/teranode-asset-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bsv-blockchain/teranode-asset-service-api/versions/5bc9be41e029/schema)