Get KYC Group by ID

Reads one KYC group of a KYC token. A group that lives on another KYC token is reported as not found.

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}

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

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/kycs/68c4a1f2b9e3d70012a5c3e8/groups/68d2e7a9c1b4f30045e1a9b2' \
  --header 'Authorization: Bearer <access_token>'

Response

Status 200.

{
  "id": "68d2e7a9c1b4f30045e1a9b2",
  "kyc_token_id": "68c4a1f2b9e3d70012a5c3e8",
  "group_id": 12,
  "name": "Accredited Investors",
  "created_at": "2026-10-02T09:14:31.512Z",
  "updated_at": "2026-10-02T09:14:31.512Z"
}

Response Fields

Field	Type	Description
id	string	The group's id. Every path and every token rule uses this value
kyc_token_id	string	The KYC token the group lives on. Absent on groups created before groups were tied to a KYC token
group_id	integer	The group's number on chain; unique across the platform
name	string	The group's name
created_at	string	When the group was created (ISO 8601)
updated_at	string	When the group last changed (ISO 8601)

Errors

Status	Code	Description
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.