List Node KYC Addresses

Lists the KYC address rules on every token a node owns, newest first: the view that answers "where does this wallet appear on my node" without paging every token. It covers the node's own tokens, not its descendants' tokens, and leaves out rules recorded before rules carried a node.

Your node must be this node or one of its ancestors.

Required permission: kyc:token:view

Request

GET /v2/admin/nodes/{node_id}/kyc/addresses

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node's id
type	string	query	Optional. whitelist, blacklist or distribution. Any other value is refused
address	string	query	Optional. Part of an address; matches ignoring letter case
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/665ae536a6392b75cfd40352/kyc/addresses?address=0x1234&page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "data": [
    {
      "id": "68d3a1b2c4e5f60078a9b0c1",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "node_id": "665ae536a6392b75cfd40352",
      "address": "0x1234567890123456789012345678901234567890",
      "type": "blacklist",
      "created_at": "2026-10-02T09:14:31.512Z",
      "updated_at": "2026-10-02T09:14:31.512Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	The rules on this page, newest first
data[].id	string	The rule's id
data[].token_id	string	The asset token the rule belongs to
data[].node_id	string	The node that owns the token. Absent on rules recorded before rules carried a node
data[].address	string	The wallet address, exactly as it was sent
data[].type	string	whitelist, blacklist or distribution
data[].created_at	string	When the rule was added (ISO 8601)
data[].updated_at	string	When the rule last changed (ISO 8601)
total	integer	Items matching the filters
page	integer	Page number
per_page	integer	Page size

Errors

Status	Code	Description
400	10015	Validation failed — see details
400	10016	node_id is not a valid id
400	10001 (domain 2)	Node not found
403	10005 (domain 2)	The node is outside your node's subtree

See Errors for the error format and common codes.