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

# List MicroVault activity

> Returns the vault's user-visible money-movement history in reverse chronological order, including current operation status and known transaction hashes.

List subscription, rebalance, and redemption activity.

<Note>
  MicroVaults are in private preview for enabled sandbox organizations on Ethereum Sepolia.
</Note>


## OpenAPI

````yaml swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/activity
openapi: 3.0.0
info:
  title: Ground API
  description: Core API for Portfolio Wallets, gtokens, MicroVaults, and webhooks.
  version: 2.0.0
servers:
  - url: https://sandbox.groundtech.co
  - url: https://production.groundtech.co
security:
  - bearerAuth: []
tags:
  - name: System
    description: System health and utility endpoints.
  - name: Sandbox Faucets
    description: Sandbox-only test token faucets.
  - name: Portfolio Wallets
    description: >-
      Portfolio wallets with strategy allocation, deposits, withdrawals, and
      yield positions.
  - name: gVaults
    description: >-
      Direct access to gtokens with deposit access controls and optional fee
      wrappers.
  - name: MicroVaults
    description: >-
      Customer-owned onchain vaults with externally held ERC-20 shares. Private
      preview in sandbox on Ethereum Sepolia.
  - name: Webhook Endpoints
    description: Webhook endpoint management for portfolio wallet notifications.
paths:
  /v2/microvaults/vaults/{vaultId}/activity:
    parameters:
      - name: vaultId
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/UuidV4'
        description: >-
          Ground identifier of the MicroVault. This is distinct from its onchain
          contract address.
    get:
      tags:
        - MicroVaults
      summary: List subscriptions, rebalances, and redemptions
      description: >-
        Returns the vault's user-visible money-movement history in reverse
        chronological order, including current operation status and known
        transaction hashes.
      operationId: listMicrovaultActivity
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
          description: Maximum number of records to return in this page.
        - name: cursor
          in: query
          schema:
            type: string
            maxLength: 512
          description: >-
            Opaque continuation token from the preceding response's
            `nextCursor`. Omit for the first page.
      responses:
        '200':
          description: Activity in reverse chronological order.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MicroVaultActivityList'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    UuidV4:
      type: string
      format: uuid
      pattern: >-
        ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
      example: 8f4c52d7-62ab-4db9-a964-92f481f6b851
    MicroVaultActivityList:
      type: object
      required:
        - items
        - nextCursor
      properties:
        items:
          type: array
          description: >-
            Subscriptions, rebalances, and redemptions in reverse chronological
            order.
          items:
            type: object
            additionalProperties: true
            required:
              - id
              - createdAt
              - kind
              - status
              - actor
              - txHash
              - details
            properties:
              id:
                allOf:
                  - $ref: '#/components/schemas/UuidV4'
                description: Ground identifier of this activity record.
              createdAt:
                type: string
                format: date-time
                description: Time when the activity was created or observed.
              kind:
                type: string
                enum:
                  - subscription
                  - rebalance
                  - redemption
                description: User-visible vault operation represented by this record.
              status:
                type: string
                description: Current completion state of the operation.
              actor:
                allOf:
                  - $ref: '#/components/schemas/NonzeroEvmAddress'
                nullable: true
                description: >-
                  Wallet that initiated the operation, or `null` when no
                  shareholder actor applies.
              txHash:
                type: string
                pattern: ^0x[0-9a-fA-F]{64}$
                nullable: true
                description: >-
                  Most relevant onchain transaction hash currently known for
                  this activity.
              details:
                type: object
                additionalProperties: true
                description: >-
                  Amounts, share data, receiver, request ID, and source progress
                  relevant to this operation.
        nextCursor:
          type: string
          nullable: true
          description: >-
            Continuation token for the next page, or `null` when this is the
            last page.
      example:
        items:
          - id: 8c415937-77dd-4d92-a600-5a40a34b4114
            createdAt: '2026-09-10T18:41:00.000Z'
            kind: subscription
            status: confirmed
            actor: '0x76f8fc6667e239f83a547d4e16225d6a34f6fa22'
            txHash: '0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'
            details:
              amountAssets: '1000000'
              shares: '997600000000000000'
        nextCursor: null
    NonzeroEvmAddress:
      type: string
      description: >-
        Valid nonzero EVM EOA or contract address. Mixed-case values must use a
        valid EIP-55 checksum.
      minLength: 42
      maxLength: 42
      pattern: ^0x(?!0{40}$)[0-9a-fA-F]{40}$
      example: '0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81'
    AuthErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Authentication or authorization error message.
        message:
          type: string
          nullable: true
          description: Additional auth middleware detail, when present.
        code:
          type: string
          nullable: true
          enum:
            - unauthenticated
            - forbidden
          description: >-
            Some auth and scope failures include a stable code; middleware
            errors may omit it.
  responses:
    Unauthorized:
      description: >-
        The request is missing a valid bearer token, or the token is invalid or
        expired.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AuthErrorResponse'
          example:
            error: Unauthenticated request
            message: Missing or invalid bearer token
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````