> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantumapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List and get token operations

> Track every privileged token action with full lifecycle, transaction-hash, and audit linkage.

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.

```json theme={null}
{
  "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](/concepts/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.                       |

## Related

* [Lifecycle](/qustody/token-management/token-operation-lifecycle)
* [Token webhooks](/qustody/token-management/token-webhooks)
* [Object model](/qustody/token-management/objects)