---
title: "Get sub-account transaction activities"
method: GET
path: "/ledger/subaccounts/{subAccountIdRef}/activities"
tags: ["ledger-account activity"]
---

# Get sub-account transaction activities

`GET /ledger/subaccounts/{subAccountIdRef}/activities`

This operation allows the client to fetch a paginated, aggregated feed of all
transaction activities for a sub-account (cash deposits/payments, account-number
deposits, crypto deposits/withdrawals, internal transfers, offramp deposits),
each with type-specific details in activityData.

## Path parameters

- `subAccountIdRef` string, required

## Query parameters

- `type` TransactionActivityType[]
- `direction` 'CREDIT' | 'DEBIT'
- `startDate` string, date-time
- `endDate` string, date-time
- `page` integer
- `size` integer

## Response `200`

Activities fetched successfully

- TransactionActivityList — Base object for paginated list
  - `name` string — Descriptive name for the list
  - `size` integer — Positive integer
  - `totalItems` integer — Positive integer
  - `nextPage` integer — Positive integer
  - `previousPage` integer — Positive integer
  - `content` TransactionActivity[] — List of transaction activities
    - `id` string, uuid, required
    - `activityType` string, required — Discriminator; the concrete activity model name, e.g. CashDepositActivity.
    - `type` 'CASH_DEPOSIT' | 'CASH_PAYMENT' | 'ACCOUNT_NUMBER_DEPOSIT' | 'CRYPTO_WITHDRAWAL' | 'CRYPTO_DEPOSIT' | 'INTERNAL_TRANSFER' | 'OFFRAMP_DEPOSIT', required — Semantic category of a transaction activity feed entry.
    - `direction` 'CREDIT' | 'DEBIT', required
    - `amount` number, required — Always positive; see direction for credit/debit.
    - `currency` string, required
    - `status` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'SUCCESS', required — Status of the transaction, indicating its current state in the processing lifecycle. - PENDING: The transaction has been created but not yet processed. - IN_PROGRESS: The transaction is currently being processed. - FAILED: The transaction processing has failed. - SUCCESS: The transaction has been successfully processed.
    - `reference` string — Customer-facing reference of the source transaction.
    - `accountId` string, uuid, required
    - `accountType` 'MAIN' | 'SUB_ACCOUNT' | 'OFFRAMP_ACCOUNT', required — The kind of account a transaction activity occurred on.
    - `subAccountId` string, uuid — Set when accountType is SUB_ACCOUNT.
    - `accountTransactionId` string — Identifier of the transaction on the ledger account, when available.
    - `groupId` string, uuid — Links related activities together, e.g. the two legs of an internal transfer, or an offramp deposit and its refund.
    - `narration` string
    - `activityAt` string, date-time, required

## Other responses

- `400` — Request could not be validated
- `401` — Client is not authorized to make request
- `403` — Expected permission is not available.
- `default` — Internal Server Error

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/76329919f8a7/schema)