Skip to main content

Add Token Whitelist Group

Adds a KYC group to a token's whitelist.

Request

POST /v2/admin/kyc/tokens/{tokenID}/whitelist/groups/{groupID}

Parameters

NameTypeInDescription
tokenIDstringpathRequired. The ID of the token
groupIDstringpathRequired. The ID of the KYC group to add to whitelist

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication

Example

curl --request POST \
--url '{{baseUrl}}/v2/admin/kyc/tokens/67d8774e903bfcbe7eb5d93e/whitelist/groups/67d8774e903bfcbe7eb5d93f' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

A successful request returns an HTTP 201 status code with the action response.

{
"requires_approval": false,
"completed": true
}

Response Fields

FieldTypeDescription
requires_approvalbooleanWhether the action requires approval
completedbooleanWhether the action was completed immediately

Status Codes

Status CodeDescription
201Success - KYC group added to token whitelist
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing authentication token
404Not Found - Token ID or KYC group ID does not exist
409Conflict - KYC group already exists in token whitelist
500Internal Server Error