Skip to main content
GET
/
api
/
v1
/
network
/
nodes
Get the network address book nodes
curl --request GET \
  --url https://mainnet.mirrornode.hedera.com/api/v1/network/nodes
{
  "nodes": [
    {
      "admin_key": {
        "_type": "ED25519",
        "key": "15706b229b3ba33d4a5a41ff54ce1cfe0a3d308672a33ff382f81583e02bd743"
      },
      "decline_reward": false,
      "description": "address book 1",
      "file_id": "0.0.102",
      "max_stake": 50000,
      "memo": "0.0.4",
      "min_stake": 1000,
      "node_account_id": "0.0.4",
      "node_cert_hash": "0x01d173753810c0aae794ba72d5443c292e9ff962b01046220dd99f5816422696e0569c977e2f169e1e5688afc8f4aa16",
      "node_id": 1,
      "public_key": "0x4a5ad514f0957fa170a676210c9bdbddf3bc9519702cf915fa6767a40463b96f",
      "reward_rate_start": 1000000,
      "service_endpoints": [
        {
          "ip_address_v4": "128.0.0.6",
          "port": 50216
        }
      ],
      "stake": 20000,
      "stake_not_rewarded": 19900,
      "stake_rewarded": 100,
      "staking_period": {
        "from": "1655164800.000000000",
        "to": "1655251200.000000000"
      },
      "timestamp": {
        "from": "187654.000123457",
        "to": null
      }
    }
  ],
  "links": {
    "next": null
  }
}

Query Parameters

​
file.id
string

The ID of the file entity

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$
​
limit
integer<int32>
default:25

The maximum number of items to return

Required range: 1 <= x <= 100
​
node.id
string

The ID of the node

Pattern: ^((eq|gt|gte|lt|lte):)?\d{1,19}$
​
order
enum<string>
default:asc

The order in which items are listed

Available options:
asc,
desc

Response

OK

​
nodes
object[]
required
​
links
object
required