Get Node

Returns one node. The node must be your own node or one below it in the hierarchy; any other node is refused with 10005.

A node's contracts and wallets are not part of this response: contracts belong to the node's setups (List Node Setups) and wallets are listed by List Node Wallets.

Required permission: node:view

Request

GET /v2/admin/nodes/{node_id}

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node's id

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "id": "6a4bef2b1e781b11c22e9707",
  "parent_id": "665ae536a6392b75cfd40352",
  "parent_name": "Apex",
  "name": "Tostik 5",
  "type": 2,
  "status": 1,
  "contract": null,
  "meta": {
    "logo": {
      "url": "https://s3.tokenizationtr.com/nodes/6a4bef2b1e781b11c22e9707/logo.png"
    },
    "color": {
      "primary_color": "#1F2937",
      "secondary_color": "#F59E0B"
    }
  },
  "int_id": 38,
  "path": "1.38",
  "listed_token_count": 3,
  "supervisor_count": 2,
  "created_by": "665b372f3a72d7d0791596ba",
  "created_by_supervisor": {
    "id": "665b372f3a72d7d0791596ba",
    "name": "Jane",
    "surname": "Doe",
    "email": "admin@example.com"
  },
  "created_at": "2026-03-16T12:29:59.46Z"
}

Response Fields

Field	Type	Description
id	string	Node id
parent_id	string | null	Parent node id. null for the platform node
parent_name	string | null	Parent node name. null for the platform node
name	string	Node name
type	integer	Node type, see Node types
status	integer	Node status, see Node statuses
contract	null	Always null. Contracts are deployed per setup; read them with Get Setup Contracts
meta	object | null	Branding. null when nothing was set
meta.logo.url	string	Logo URL. meta.logo is null when the node has no logo
meta.color.primary_color	string	Primary brand colour. meta.color is null when no colours were set
meta.color.secondary_color	string	Secondary brand colour
int_id	integer	Sequential numeric id of the node
path	string	The node's position in the hierarchy: the int_id of every ancestor and of the node itself, joined by . (for example 1.38)
listed_token_count	integer	Number of listed tokens on the node
supervisor_count	integer	Number of supervisors on the node
created_by	string	Id of the supervisor who created the node. Omitted when unknown
created_by_supervisor	object	That supervisor's id, name, surname and email. Omitted when unknown; name and surname are omitted when not set
created_at	string	Creation time (ISO 8601)

Node types

Value	Name	Description
1	Apex	The platform (root) node
2	Account	A node directly under the platform node
3	SubAccount	A node under an account or under another sub-account

Node statuses

Value	Name	Description
1	Active	The node is active
2	Passive	The node is passive
3	Creating	The node is being set up: an account node starts here, and a node returns here while a wallet is being provisioned for it (Create Node Wallet)

Errors

Status	Code	Description
400	10016	node_id is not a valid id
400	10001	Node not found (node domain 2)
403	10005	The node is outside your part of the hierarchy (node domain 2)

See Errors for the error format and common codes.