Skip to main content
Every privileged token action — deploy, mint, burn, transfer, role grant/revoke, pause, freeze, compliance update — produces a TokenOperation. Operations link 1:1 to the underlying Qustody transaction and to the resulting on-chain transaction hash once broadcast.

​
GET /v1/token-operations

List token operations across one or more tokens.
AspectDetail
MethodGET
Path/v1/token-operations
AuthenticationBearer API key
Required permissionstokens:read
IdempotentYes — read-only

​
Query parameters

NameTypeDescription
tokenIdstringFilter by token.
operationTypestringFilter by operation type (see list below).
statusstringFilter by lifecycle status.
requestedBystringFilter by requesting user.
limit / offsetintegerPagination.

​
GET /v1/token-operations/{operationId}

Fetch a single operation. 
{
  "operationId": "op_mint_123",
  "tokenId": "token_abc123",
  "operationType": "MINT",
  "status": "COMPLETED",
  "transactionRequestId": "txreq_002",
  "blockchainTransactionHash": "0x4ab1…",
  "amount": "1000000000000000000000",
  "requestedBy": "user_8f3c…",
  "approvedBy": ["user_a01b…"],
  "createdAt": "2026-04-27T10:05:00Z",
  "updatedAt": "2026-04-27T10:07:12Z",
  "failureReason": null
}

​
Operation types

CREATE_TOKEN, DEPLOY_TOKEN, MINT, BURN, TRANSFER, GRANT_ROLE, REVOKE_ROLE, PAUSE, UNPAUSE, FREEZE, UNFREEZE, UPDATE_COMPLIANCE, ALLOWLIST_ADD, ALLOWLIST_REMOVE.

​
Status values

Token operations reuse the existing transaction state machine. Possible values: SUBMITTED, QUEUED, PENDING_AUTHORIZATION, APPROVED, REJECTED, PENDING_SIGNATURE, SIGNED, BROADCASTING, CONFIRMING, COMPLETED, FAILED, CANCELLED.

​
Errors

CodeTypeMeaning
1715TOKEN_OPERATION_ALREADY_PROCESSEDOperation already reached a terminal state.
1300TX_NOT_FOUNDOperation ID unknown.