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

# Get registered nodes

`GET /api/v1/network/registered-nodes`

Returns the list of registered nodes

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `registerednode.id` string
- `type` 'BLOCK_NODE' | 'GENERAL_SERVICE' | 'MIRROR_NODE' | 'RPC_RELAY' — Registered node type.

## Response `200`

OK

- RegisteredNodesResponse
  - `registered_nodes` RegisteredNode[], required
    - `admin_key` Key, nullable, required — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `created_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
    - `description` string, nullable, required — A short description of the node
    - `registered_node_id` integer, required — An identifier for the registered node
    - `service_endpoints` RegisteredServiceEndpoint[], required
      - union
        - object
          - `block_node` RegisteredBlockNodeEndpoint, required
            - `endpoint_apis` RegisteredBlockNodeApi[]
          - `domain_name` string, nullable, required — The DNS domain name of the service
          - `general_service` RegisteredGeneralServiceEndpoint, required
            - `description` string
          - `ip_address` string, nullable — The IP address of the service
          - `mirror_node` RegisteredMirrorNodeEndpoint, required
          - `port` integer, required
          - `requires_tls` boolean, required — Whether the registered service endpoint requires TLS or not.
          - `rpc_relay` RegisteredRpcRelayEndpoint, required
          - `type` 'BLOCK_NODE' | 'GENERAL_SERVICE' | 'MIRROR_NODE' | 'RPC_RELAY', required — Registered node type.
        - object
          - `block_node` RegisteredBlockNodeEndpoint, required
            - `endpoint_apis` RegisteredBlockNodeApi[]
          - `domain_name` string, nullable — The DNS domain name of the service
          - `general_service` RegisteredGeneralServiceEndpoint, required
            - `description` string
          - `ip_address` string, nullable, required — The IP address of the service
          - `mirror_node` RegisteredMirrorNodeEndpoint, required
          - `port` integer, required
          - `requires_tls` boolean, required — Whether the registered service endpoint requires TLS or not.
          - `rpc_relay` RegisteredRpcRelayEndpoint, required
          - `type` 'BLOCK_NODE' | 'GENERAL_SERVICE' | 'MIRROR_NODE' | 'RPC_RELAY', required — Registered node type.
    - `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)