Token APIs

Endpoints for listing Hedera tokens and managing user token associations, KYC status, and freeze status in Guardian.

Authentication: Bearer token required (Authorization: Bearer <token>)

---

Method	Endpoint	Description	Auth Required
GET	/api/v1/tokens	Returns all tokens; includes balances and statuses for non-Standard-Registry users	Yes
POST	/api/v1/tokens/{tokenId}/{username}/associate	Associates a user with the specified token	Yes
DELETE	/api/v1/tokens/{tokenId}/{username}/dissociate	Disassociates a user from the specified token	Yes
PUT	/api/v1/tokens/{tokenId}/{username}/freeze	Freezes the user's token balance	Yes
PUT	/api/v1/tokens/{tokenId}/{username}/unfreeze	Unfreezes the user's token balance	Yes
PUT	/api/v1/tokens/{tokenId}/{username}/grantKyc	Grants KYC status to the user for the token	Yes
PUT	/api/v1/tokens/{tokenId}/{username}/revokeKyc	Revokes KYC status from the user for the token	Yes
GET	/api/v1/tokens/{tokenId}/{username}/info	Returns token information and status for the specified user	Yes
GET	/api/v1/tokens/{tokenId}/serials	Returns the serial numbers for the specified token	Yes
POST	/api/v1/tokens/{tokenId}/transfer	Transfers tokens to a target account	Yes

Endpoints

• Token Listing

• Token Listing (v1)

• Associates the User with Token

• Disassociates the User with Token

• Freeze Tokens of a User

• Unfreeze Tokens of a User

• Grants KYC for the User

• Revoke KYC of the User

• User Info for Selected Token

• Returns Token Serials

• Token Transfer