List KYC Group Members

Lists the addresses in a KYC group, newest first. A member appears as soon as its addition is accepted (and stays if the on-chain call fails), and leaves once its removal is confirmed.

Only the platform owner (root) node may call it.

Required permission: kyc:group:view

Request

GET /v2/admin/kycs/{kyc_token_id}/groups/{group_id}/members

Parameters

Name	Type	In	Description
kyc_token_id	string	path	Required. The KYC token's id, from List KYC Tokens
group_id	string	path	Required. The group's id (24-character hex), not its numeric group_id
search	string	query	Optional. An address to look up. It matches the whole address, ignoring letter case; it is not a partial match
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/kycs/68c4a1f2b9e3d70012a5c3e8/groups/68d2e7a9c1b4f30045e1a9b2/members?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "data": [
    {
      "id": "68d2e8f0a7c3b50061f2c4d5",
      "kyc_group_id": "68d2e7a9c1b4f30045e1a9b2",
      "address": "0x1234567890123456789012345678901234567890",
      "created_at": "2026-10-02T09:14:31.512Z",
      "updated_at": "2026-10-02T09:14:31.512Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Response Fields

Field	Type	Description
data	array	The members on this page, newest first
data[].id	string	The membership's id
data[].kyc_group_id	string	The group's id
data[].address	string	The wallet address, exactly as it was sent
data[].created_at	string	When the member was added (ISO 8601)
data[].updated_at	string	When the membership 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
403	10005 (domain 2)	Your node is not the platform owner (root) node
400	20001001	KYC group not found, or it lives on another KYC token than the path names

See Errors for the error format and common codes.