---
title: "Get the network address book nodes"
method: GET
path: "/api/v1/network/nodes"
tags: ["network"]
---

# Get the network address book nodes

`GET /api/v1/network/nodes`

Returns the network's list of nodes used in consensus

## Query parameters

- `file.id` string
- `limit` integer
- `node.id` string
- `order` 'asc' | 'desc'

## Response `200`

OK

- NetworkNodesResponse
  - `nodes` NetworkNode[], required
    - `admin_key` Key, nullable, required — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `associated_registered_nodes` integer[], required
    - `decline_reward` boolean, nullable, required — Whether the node wants to receive staking rewards or not.
    - `description` string, nullable, required — a memo associated with the address book
    - `file_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `grpc_proxy_endpoint` ServiceEndpoint, required
      - `domain_name` string, required
      - `ip_address_v4` string, required
      - `port` integer, required
    - `max_stake` integer, nullable, required — The maximum stake (rewarded or not rewarded) this node can have as consensus weight
    - `memo` string, nullable, required — memo
    - `min_stake` integer, nullable, required — The minimum stake (rewarded or not rewarded) this node must reach before having non-zero consensus weight
    - `node_account_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `node_id` integer, required — An identifier for the node
    - `node_cert_hash` string, nullable, required — hex encoded hash of the node's TLS certificate
    - `public_key` string, nullable, required — hex encoded X509 RSA public key used to verify stream file signature
    - `reward_rate_start` integer, nullable, required — The total tinybars earned by this node per whole hbar in the last staking period
    - `service_endpoints` ServiceEndpoint[], required
      - `domain_name` string, required
      - `ip_address_v4` string, required
      - `port` integer, required
    - `stake` integer, nullable, required — The node consensus weight at the beginning of the staking period
    - `stake_not_rewarded` integer, nullable, required — The sum (balance + stakedToMe) for all accounts staked to this node with declineReward=true at the beginning of the staking period
    - `stake_rewarded` integer, nullable, required — The sum (balance + staked) for all accounts staked to the node that are not declining rewards at the beginning of the staking period
    - `staking_period` object, nullable, required — The timestamp range of the staking period
      - `from` string — The inclusive from timestamp in seconds
      - `to` string, nullable — The exclusive to timestamp in seconds
    - `timestamp` TimestampRange, required — A timestamp range an entity is valid for
      - `from` string — The inclusive from timestamp in seconds
      - `to` string, nullable — The exclusive to timestamp in seconds
  - `links` Links, required
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)