---
title: "Returns information about the node with the given main account."
method: GET
path: "/nodes/{publicKey}"
tags: ["node"]
---

# Returns information about the node with the given main account.

`GET /nodes/{publicKey}`

## Path parameters

- `publicKey` string, required

## Response `200`

The node information.

- NodeInfo — Node information gathered from the chain by the statistics service.
  - `publicKey` string, required — Node's main account's public key.
  - `roles` integer, required — A number that defines the different roles the node provides. Possible roles are: * 1 - Peer node. * 2 - API node. * 4 - Voting node. * 64 - IPv4 compatible node * 128 - IPv6 compatible node. The values are bitwise added together, for example: 1 = Only Peer. 2 = Only API. 3 = Both Peer and API node. 7 = Peer, API and Voting node. 65 = IPv4 and Peer node.
  - `version` integer, required — The version is encoded as a single 4-byte integer, where the Most-Significant Byte encodes the Major version, and the rest of bytes are the Minor, the Micro and the Patch version. For example, version 16777472 (decimal) is 01000100h (hex), which corresponds to version 1.0.1.0.
  - `friendlyName` string, required — Node friendly name.
  - `networkGenerationHashSeed` string, required — Hash seed of the network this node is connected to. All nodes connected to the same network have the same [Hash Seed](https://docs.symbolplatform.com/guides/network/configuring-network-properties.html#network-configuration).
  - `port` integer, required — Port used for the communication.
  - `networkIdentifier` 104 | 152 — Network type: * 0x68 (104 decimal) - Public main network. * 0x98 (152 decimal) - Public test network.
  - `host` string, required — Server IP or Hostname
  - `peerStatus` PeerStatus, required — The status of the peer node.
    - `lastStatusCheck` integer, required — When was the peer last contacted, in milliseconds elapsed since UNIX epoch (January 1, 1970 00:00:00 UTC).
    - `isAvailable` boolean, required — Whether the node is currently available (reachable and answering queries).
  - `apiStatus` ApiStatus — The status of the API node. Information comes from the REST gateway.
    - `webSocket` WebSocketStatus, required
      - `isAvailable` boolean
      - `wss` boolean
      - `url` string
    - `restGatewayUrl` string, required — The REST gateway URL ready to be connected to.
    - `isAvailable` boolean, required — Whether the API is ready to accept queries.
    - `lastStatusCheck` integer, required — When was the API last checked, in milliseconds elapsed since UNIX epoch (January 1, 1970 00:00:00 UTC).
    - `nodeStatus` NodeStatus — The status of the REST gateway.
      - `apiNode` string — Whether the front-end REST gateway is up and running. Possible values are `up` and `down`. Node needs to be restarted if `down`.
      - `db` string — Whether the back-end database is up and running. Possible values are `up` and `down`. Node needs to be restarted if `down`.
    - `isHttpsEnabled` boolean, required — Whether the API accepts connections through HTTPS.
    - `nodePublicKey` string, required — Node's public key used to stablish TLS connections and [delegated harvesting](https://docs.symbolplatform.com/guides/harvesting/activating-delegated-harvesting-manual.html), for example.
    - `chainHeight` integer, required — Current chain height as reported by this node.
    - `finalization` Finalization, required — Status of the [finalization](https://docs.symbolplatform.com/concepts/block.html#finalization) gadget.
      - `height` integer — The latest finalized block of the blockchain. This block and all blocks before it are immutable and cannot be rolled back.
      - `epoch` integer — Current [finalization epoch](https://docs.symbolplatform.com/concepts/block.html#finalization).
      - `point` integer — Current [finalization point](https://docs.symbolplatform.com/concepts/block.html#finalization).
      - `hash` string
    - `restVersion` string, required — Version of the REST API used by this node.
  - `hostDetail` HostDetail, required — Location details of the node.
    - `host` string, required — The IP or hostname of the node.
    - `coordinates` Coordinates — The world coordinates of the node based on its IP address.
      - `latitude` integer, required
      - `longitude` integer, required
    - `location` string — Text description of the host's location.
    - `ip` string
    - `organization` string — Text description of the organization managing this node.
    - `as` string — AS number and organization, separated by space (RIR).
    - `continent` string
    - `country` string
    - `region` string
    - `city` string
    - `district` string
    - `zip` string

## Other responses

- `404` — There is no node with the given main account.

---

[API](https://skmtc.net/symbol/apis/symbol-statistic-service-api-documentation.md) · [All operations](https://skmtc.net/symbol/apis/symbol-statistic-service-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/symbol/symbol-statistic-service-api-documentation/versions/a81c43c55f5f/schema)