List Token KYC Addresses

Lists every KYC address rule on a token — whitelist, blacklist and distribution group together — newest first. Narrow it with type and address. Like the per-list reads, this is the platform's record: see Asynchronous writes.

Your node must be the token's node or one of its ancestors.

Required permission: kyc:token:view

Request

GET /v2/admin/tokens/{token_id}/kyc/addresses

Parameters

Name	Type	In	Description
token_id	string	path	Required. The asset token's id
type	string	query	Optional. whitelist, blacklist or distribution. The value is not validated: any other value matches nothing
address	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/tokens/68ae06cfcccf4e8fc19362d1/kyc/addresses?type=blacklist&page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "data": [
    {
      "id": "68d3a1b2c4e5f60078a9b0c1",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "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": 10
}

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[].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	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.