> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt > Use this file to discover all available pages before exploring further. # List pending operations > This operation retrieves pending approval operations for the authenticated principal. Human owners see all operations on their wallets. Agents see operations they initiated. Use cursor-based pagination with `after`/`before`. ## OpenAPI ````yaml get /api/v1/pending-operations openapi: 3.1.0 info: title: Cobo Agentic Wallet Service description: Unified wallet engine for human and agent principals version: 1.3.0 servers: [] security: [] paths: /api/v1/pending-operations: get: tags: - Pending Operations summary: List pending operations description: >- This operation retrieves pending approval operations for the authenticated principal. Human owners see all operations on their wallets. Agents see operations they initiated. Use cursor-based pagination with `after`/`before`. operationId: list_pending_operations parameters: - name: status in: query required: false schema: $ref: '#/components/schemas/PendingOperationStatus' description: >- Filter by operation status. Possible values: `pending`, `approved`, `rejected`, `expired`. If omitted, all statuses are returned. title: Status nullable: true description: >- Filter by operation status. Possible values: `pending`, `approved`, `rejected`, `expired`. If omitted, all statuses are returned. - name: after in: query required: false schema: description: >- A cursor for forward pagination. Pass the `after` value from a previous response to retrieve the next page. title: After type: string nullable: true description: >- A cursor for forward pagination. Pass the `after` value from a previous response to retrieve the next page. - name: before in: query required: false schema: description: >- A cursor for backward pagination. Pass the `before` value from a previous response to retrieve the preceding page. title: Before type: string nullable: true description: >- A cursor for backward pagination. Pass the `before` value from a previous response to retrieve the preceding page. - name: offset in: query required: false schema: description: Deprecated. Use `after`/`before` cursors instead. deprecated: true title: Offset type: integer maximum: 9223372036854776000 minimum: 0 nullable: true description: Deprecated. Use `after`/`before` cursors instead. deprecated: true - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: 'The maximum number of items to return. Range: [1, 200].' default: 50 title: Limit description: 'The maximum number of items to return. Range: [1, 200].' - name: X-API-Key in: header required: false schema: title: X-Api-Key type: string nullable: true responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/StandardResponse_PendingOperationListResponse_ '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/WrappedValidationError' components: schemas: PendingOperationStatus: type: string enum: - pending - executing - rejected - executed title: PendingOperationStatus description: Approval workflow status. StandardResponse_PendingOperationListResponse_: properties: success: type: boolean title: Success default: true result: $ref: '#/components/schemas/PendingOperationListResponse' suggestion: type: string title: Suggestion default: '' message: type: string title: Message default: '' meta: $ref: '#/components/schemas/PaginationMeta' nullable: true type: object required: - result title: StandardResponse[PendingOperationListResponse] WrappedValidationError: title: WrappedValidationError type: object required: - success - error properties: success: type: boolean const: false default: false title: Success error: type: object title: Error required: - detail properties: detail: type: array title: Detail items: $ref: '#/components/schemas/ValidationError' PendingOperationListResponse: properties: items: items: $ref: '#/components/schemas/PendingOperationRead' type: array title: Items description: The list of pending operations. total: type: integer title: Total description: >- The total number of pending operations matching the filter when using offset-based pagination. When using cursor-based pagination (`after`/`before`), this field is `0` (the true total is not computed); see response `meta` for `has_more` and cursors. default: 0 type: object required: - items title: PendingOperationListResponse description: Paginated list response for pending operations. PaginationMeta: properties: total: title: Total type: integer nullable: true offset: title: Offset type: integer nullable: true limit: title: Limit type: integer nullable: true has_more: title: Has More type: boolean nullable: true after: title: After type: string nullable: true before: title: Before type: string nullable: true type: object title: PaginationMeta description: |- Pagination metadata for list responses. Supports both legacy offset-based and cursor-based pagination. Cursor fields (``has_more``, ``after``, ``before``) are populated for cursor-paginated endpoints. Legacy fields (``offset``, ``limit``) are populated when the caller uses the deprecated ``offset`` parameter. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError PendingOperationRead: properties: id: type: string format: uuid title: Id description: The pending operation ID. owner_id: type: string format: uuid title: Owner Id description: The ID of the wallet owner who must approve this operation. request_id: title: Request Id description: >- The client-supplied request identifier from the original transfer or contract call. type: string nullable: true wallet_id: type: string format: uuid title: Wallet Id description: The wallet ID associated with this pending operation. initiated_by: type: string format: uuid title: Initiated By description: The ID of the principal that initiated this operation. delegation_id: title: Delegation Id description: >- The delegation ID under which this operation was initiated. Null for owner-initiated operations. type: string format: uuid nullable: true operation_type: $ref: '#/components/schemas/PendingOperationType' description: >- The type of operation awaiting approval. Possible values: `transfer`, `contract_call`. operation_data: additionalProperties: true type: object title: Operation Data description: >- The original operation parameters (transfer amount, destination address, contract call data, etc.). policy_decision: title: Policy Decision description: The policy decision details that triggered the approval requirement. additionalProperties: true type: object nullable: true status: $ref: '#/components/schemas/PendingOperationStatus' description: >- The pending operation status. Possible values: `pending`, `approved`, `rejected`, `expired`, `cancelled`. operation_token: title: Operation Token description: The operation token for Cobo Agentic Wallet app push notifications. type: string format: uuid nullable: true approved_by: title: Approved By description: >- The ID of the principal that approved this operation. Null if not yet approved. type: string format: uuid nullable: true approved_at: title: Approved At description: The timestamp when this operation was approved, in ISO 8601 format. type: string format: date-time nullable: true rejected_by: title: Rejected By description: >- The ID of the principal that rejected this operation. Null if not rejected. type: string format: uuid nullable: true rejected_at: title: Rejected At description: The timestamp when this operation was rejected, in ISO 8601 format. type: string format: date-time nullable: true expires_at: type: string format: date-time title: Expires At description: >- The timestamp when this pending operation expires, in ISO 8601 format. execution_result: additionalProperties: true type: object title: Execution Result description: The execution result after the operation was approved and submitted. last_error: title: Last Error description: The last error message, if execution failed. type: string nullable: true created_at: type: string format: date-time title: Created At description: >- The timestamp when this pending operation was created, in ISO 8601 format. updated_at: type: string format: date-time title: Updated At description: >- The timestamp when this pending operation was last updated, in ISO 8601 format. type: object required: - id - owner_id - request_id - wallet_id - initiated_by - delegation_id - operation_type - operation_data - policy_decision - status - operation_token - approved_by - approved_at - rejected_by - rejected_at - expires_at - execution_result - last_error - created_at - updated_at title: PendingOperationRead description: Pending operation response payload. PendingOperationType: type: string enum: - transfer - contract_call - message_sign title: PendingOperationType description: Operations that can be queued for approval. ````