List Token Whitelist Groups

Lists the KYC groups attached to a token's whitelist, newest first. Each row is an attachment: its id is the attachment's own id (the internal_id of its node transactions), and kyc_group_id is the group's id, which the add and remove endpoints take in the path.

An attachment appears as soon as it is accepted (and stays if its transaction fails), and leaves only once a removal is confirmed. Your node must be the token's node or one of its ancestors.

Required permission: kyc:token:whitelist-group:view

Request

GET /v2/admin/tokens/{token_id}/kyc/whitelist/groups

Parameters

Name	Type	In	Description
token_id	string	path	Required. The asset token's id
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/tokens/68ae06cfcccf4e8fc19362d1/kyc/whitelist/groups?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "data": [
    {
      "id": "68d4b2c3d5e6f70089b0c1d2",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "kyc_group_id": "68d2e7a9c1b4f30045e1a9b2",
      "type": "whitelist",
      "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 attachments on this page, newest first
data[].id	string	The attachment's id
data[].token_id	string	The asset token
data[].kyc_group_id	string	The attached group's id
data[].type	string	whitelist
data[].created_at	string	When the group was attached (ISO 8601)
data[].updated_at	string	When the attachment 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	token_id is not a valid id
400	10001 (domain 5)	Token not found
403	10005 (domain 2)	The token belongs to a node outside your node's subtree

See Errors for the error format and common codes.