Get Token Blacklist
Lists the addresses on a token's blacklist, newest first.
The list is the platform's record, not a chain read: an address appears as soon as an add is accepted (and stays there if its transaction fails), and leaves only once a removal is confirmed. See Asynchronous writes.
Your node must be the token's node or one of its ancestors.
Required permission: kyc:blacklist:view
Request
GET /v2/admin/tokens/{token_id}/kyc/blacklist
Parameters
| Name | Type | In | Description |
|---|---|---|---|
token_id | string | path | Required. The asset token's 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/tokens/68ae06cfcccf4e8fc19362d1/kyc/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.