---
title: "Get node network peers"
method: GET
path: "/eth/v1/node/peers"
tags: ["Node"]
---

# Get node network peers

`GET /eth/v1/node/peers`

## Request

- Base URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key` (relative, and the document’s source URL is not known)
- URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key/eth/v1/node/peers`
- Auth: none declared

Retrieves data about the node's network peers. By default this returns all peers. Multiple query params are combined using AND conditions

## Query parameters

- `state` string[]
- `direction` string[]

## Response `200`

Request successful

- object
  - `data` object[]
    - `peer_id` string: Cryptographic hash of a peer’s public key. [Read more](https://docs.libp2p.io/concepts/peer-id/)
    - `enr` string, nullable: Ethereum node record. [Read more](https://eips.ethereum.org/EIPS/eip-778)
    - `last_seen_p2p_address` string: Multiaddrs used in last peer connection.
    - `state` 'disconnected' | 'connecting' | 'connected' | 'disconnecting'
    - `direction` 'inbound' | 'outbound'
  - `meta` object
    - `count` number: Total number of items

## Other responses

- `500`: Beacon node internal error.

---

[API](https://skmtc.dev/nodereal/apis/eth-beacon-node-api.md) - [All operations](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/revisions/1878ea8657a1?raw)