List KYC Tokens

The platform's KYC token catalog: every deployed KYC token, on every network, each row naming the network it lives on. Use it to pick the kyc_token_id a setup is wired to or a KYC group is created on, and to see what is deployed where. Only deployed tokens are listed: a token whose deploy is still running, or has failed, does not appear.

Rows are ordered by network, and oldest deployment first within a network, so a network's first row is the token a setup gets when it names none. A network with no rows cannot host a setup, because a setup's contracts are deployed with a KYC token address.

Required permission: kyc:token:view

Request

GET /v2/admin/kyc-tokens

Parameters

Name	Type	In	Description
network_id	string	query	Optional. Narrow the catalog to one network. An id that names no network is refused (10015) rather than answered with an empty page
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/kyc-tokens?network_id=68a1f0c2d4e5f60718293a4b&page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "data": [
    {
      "id": "68c4a1f2b9e3d70012a5c3e8",
      "network_id": "68a1f0c2d4e5f60718293a4b",
      "network_name": "Polygon Amoy",
      "chain_id": "68a0e1d2c3b4a59687786950",
      "evm_network_id": 80002,
      "address": "0x5b0c3f1e2d4a6b8c9e0f1a2b3c4d5e6f7a8b9c0d",
      "wallet_id": "68a2b3c4d5e6f708192a3b4c",
      "name": "Apex KYC Polygon",
      "version": "1.0.0",
      "deployed_at": "2026-10-02T09:21:07.004Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	The KYC tokens on this page
data[].id	string	The KYC token's id: the kyc_token_id used by setups and KYC groups
data[].network_id	string	The network the token is deployed on
data[].network_name	string	That network's name
data[].chain_id	string	The platform's id of the network's chain
data[].evm_network_id	integer	The EVM network id (for example 1 Ethereum, 137 Polygon)
data[].address	string	The KYC token's address (its proxy): the address a setup's contracts point at
data[].wallet_id	string	The token's owner wallet, which signs every group change and token rule written on this KYC token
data[].name	string	Display name
data[].version	string	KYC token implementation version
data[].deployed_at	string	When the deploy completed (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. Also network not found when network_id names no network
400	10016	network_id is not a valid id

See Errors for the error format and common codes.