List and get token operations

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.

Aspect	Detail
Method	`GET`
Path	`/v1/token-operations`
Authentication	Bearer API key
Required permissions	`tokens:read`
Idempotent	Yes — read-only

Query parameters

Name	Type	Description
`tokenId`	string	Filter by token.
`operationType`	string	Filter by operation type (see list below).
`status`	string	Filter by lifecycle status.
`requestedBy`	string	Filter by requesting user.
`limit` / `offset`	integer	Pagination.

`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

Code	Type	Meaning
1715	`TOKEN_OPERATION_ALREADY_PROCESSED`	Operation already reached a terminal state.
1300	`TX_NOT_FOUND`	Operation ID unknown.

Compliance and allowlist Create webhook

Overview

Health

Tenants

Vaults

Wallets

Transactions

Assets

Tokens

Webhooks

Administration

List and get token operations

`GET /v1/token-operations`

Query parameters

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

Operation types

Status values

Errors

​GET /v1/token-operations

​Query parameters

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

​Operation types

​Status values

​Errors

​Related

`GET /v1/token-operations`

Query parameters

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

Operation types

Status values

Errors

Related