> ## 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 accounting activity > Returns customer-facing accounting journal lines for either one wallet or the authenticated organization. Rows with the same journalEntryId belong to the same journal entry. nativeUnits and amountUsd are signed: positive values increase that account bucket and negative values decrease it. ## OpenAPI ````yaml swagger/swagger-combined.yaml GET /v2/accounting/activity openapi: 3.0.0 info: title: Ground API description: Core API for portfolio wallets, deposits, withdrawals, 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: Webhook Endpoints description: Webhook endpoint management for portfolio wallet notifications. paths: /v2/accounting/activity: get: tags: - Accounting summary: List accounting activity description: > Returns customer-facing accounting journal lines for either one wallet or the authenticated organization. Rows with the same journalEntryId belong to the same journal entry. nativeUnits and amountUsd are signed: positive values increase that account bucket and negative values decrease it. operationId: listAccountingActivity parameters: - name: walletId in: query required: false schema: type: string format: uuid description: >- Wallet ID for a wallet-scoped activity feed. Provide exactly one of `walletId` or `scope=organization`. - name: scope in: query required: false schema: type: string enum: - organization description: >- Use `organization` for an organization-wide activity feed. Provide exactly one of `walletId` or `scope=organization`. - name: startAt in: query required: false schema: type: string format: date-time description: >- Inclusive ISO-8601 UTC lower bound for activity timestamps. Defaults to the beginning of time when omitted. - name: endAt in: query required: false schema: type: string format: date-time description: >- Exclusive ISO-8601 UTC upper bound for activity timestamps. Defaults to the current request time when omitted. - name: cursor in: query required: false schema: type: string description: Opaque cursor from a prior response. - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 500 description: Maximum number of journal lines to return. responses: '200': description: Accounting journal line feed content: application/json: schema: type: object properties: activity: type: array items: $ref: '#/components/schemas/AccountingActivityItem' nextCursor: type: string nullable: true hasMore: type: boolean example: activity: - journalEntryId: 7c2f1b90-1d2e-4a3b-9c4d-5e6f70819203 lineNumber: 1 eventType: yield_source_deposit accountKind: cash walletId: 9d1a1c83-3a1c-4c14-9c5a-0c9a57a4a7db walletLabel: Treasury Portfolio nativeUnits: '-5000000000' amountUsd: '-5000.000000' settlementValuedAt: '2026-05-01T15:05:11.000Z' timestamp: '2026-05-01T15:05:11.000Z' chain: ethereum token: usdc yieldSourceId: null yieldSourceLabel: null bridgeId: null txHash: >- 0xb4ec6ad9f2f2d75fb8df30c6e49b1f319138f0172d7bff7c402e7dcb7f017e8a - journalEntryId: 7c2f1b90-1d2e-4a3b-9c4d-5e6f70819203 lineNumber: 2 eventType: yield_source_deposit accountKind: yield_position walletId: 9d1a1c83-3a1c-4c14-9c5a-0c9a57a4a7db walletLabel: Treasury Portfolio nativeUnits: '4998500123' amountUsd: '5000.000000' settlementValuedAt: '2026-05-01T15:05:11.000Z' timestamp: '2026-05-01T15:05:11.000Z' chain: ethereum token: usdc yieldSourceId: morpho-gauntlet-usdc yieldSourceLabel: Morpho Gauntlet USDC bridgeId: null txHash: >- 0xb4ec6ad9f2f2d75fb8df30c6e49b1f319138f0172d7bff7c402e7dcb7f017e8a nextCursor: null hasMore: false '400': description: Invalid query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_scope: value: error: Provide exactly one of walletId or scope=organization code: validation_error invalid_wallet_id: value: error: walletId must be a valid UUID v4 code: validation_error invalid_start_at: value: error: startAt must be an ISO-8601 UTC timestamp code: validation_error invalid_end_at: value: error: endAt must be an ISO-8601 UTC timestamp code: validation_error invalid_range: value: error: startAt must be earlier than endAt code: validation_error invalid_limit: value: error: limit must be a positive integer no greater than 500 code: validation_error invalid_cursor: value: error: cursor is invalid code: invalid_cursor '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: AccountingActivityItem: type: object description: >- One customer-facing accounting journal line. Rows sharing a journalEntryId belong to the same journal entry. required: - journalEntryId - lineNumber - walletId - walletLabel - eventType - accountKind - chain - token - yieldSourceId - yieldSourceLabel - bridgeId - nativeUnits - amountUsd - settlementValuedAt - timestamp - txHash properties: journalEntryId: type: string format: uuid description: >- Stable identifier shared by all lines posted for the same journal entry. lineNumber: type: integer nullable: true description: One-based line order within the journal entry. eventType: type: string description: >- Accounting event that produced this journal entry (e.g. `yield_source_deposit`, `yield_source_redeem`, `bridge_send`, `bridge_receive`, `external_payout_transfer`). accountKind: type: string description: >- Ledger account kind (e.g. `cash`, `yield_position`, `bridge`, `external_deposit`, `external_payout`). walletId: type: string format: uuid walletLabel: type: string nullable: true nativeUnits: type: string nullable: true description: >- Signed movement amount in the account's native base units, as a string. amountUsd: type: string nullable: true description: Signed USD value of the journal line, as a fixed-precision string. settlementValuedAt: type: string format: date-time nullable: true timestamp: type: string format: date-time nullable: true description: >- Customer-facing timestamp for the journal line, using settlementValuedAt when available. chain: type: string nullable: true token: type: string nullable: true yieldSourceId: type: string nullable: true yieldSourceLabel: type: string nullable: true bridgeId: type: string nullable: true txHash: type: string nullable: true ErrorResponse: type: object required: - error - code properties: error: type: string description: >- Human-readable error message. May change without notice; do not parse programmatically. code: type: string description: >- Machine-readable error code. Stable across API versions — safe to switch on in client code. enum: - validation_error - unknown_parameters - unsupported_chain - unsupported_token - invalid_destination_address - precision_overflow - invalid_cursor - unauthenticated - forbidden - wallet_not_found - wallet_limit_reached - withdrawal_not_found - deposit_not_found - yield_source_not_found - wallet_projection_unavailable - insufficient_funds - duplicate_request_id - request_id_conflict - invalid_position_weight - invalid_withdrawal_plan - payout_not_found - webhook_not_found - webhook_duplicate_url - withdrawal_not_cancellable - withdrawal_already_cancelled - withdrawal_payout_in_progress - withdrawal_policy_required - workflow_conflict - payout_already_terminal - payout_in_progress - payout_not_retryable - address_book_entry_not_found - address_book_duplicate_entry - address_book_whitelist_violation - rate_limited - rate_limit_exceeded - internal_error - wallet_creation_failed - service_temporarily_unavailable 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 TooManyRequests: description: >- Rate limit exceeded. Limits are enforced by API key/customer identity and by endpoint class. Retry with backoff; rate-limit headers are not currently emitted. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Rate limit exceeded code: rate_limited InternalServerError: description: >- An unexpected error occurred while processing the request. The request can be safely retried with the same `requestId`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error code: internal_error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````