List Node Investors

Lists the users who hold a positive balance of the node's tokens, with pagination. There is one row per investor, not per holding: a user holding several of the node's tokens, or holding them in several wallets, appears once.

Required permission: node:investors:view

Request

GET /v2/admin/nodes/{node_id}/investors

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node's id
search	string	query	Case-insensitive partial match on the user's name, surname or email
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/investors?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6a60b2d1c3e4f50012ab9f01",
      "email": "investor@example.com",
      "name": "John",
      "surname": "Smith",
      "has_kyc_token": true,
      "created_at": "2026-05-04T10:15:42.3Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	The investors
data[].id	string	User id
data[].email	string	Email address
data[].name	string	First name. Omitted when not set
data[].surname	string	Last name. Omitted when not set
data[].has_kyc_token	boolean	true when at least one of the user's wallets holds a KYC token. KYC belongs to the wallet, not to the user
data[].created_at	string	When the user registered (ISO 8601)
total	integer	Number of investors matching the filter
page	integer	Page number
per_page	integer	Items per page

The rows carry no address: a user's addresses belong to their wallets, and an investor may hold the node's tokens in several.

Errors

Status	Code	Description
400	10015	Validation failed (for example a missing page or per_page) — see details
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.