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

# Get a single sub-account transaction activity

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

This operation allows the client to fetch a specific transaction activity by its ID.

## Path parameters

- `subAccountIdRef` string, required
- `activityId` string, uuid, required

## Response `200`

Activity fetched successfully

- TransactionActivity — A single entry in the aggregated account activity feed. The concrete subtype is determined by the activityType discriminator; the type field carries the semantic category for filtering and display.
  - `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.
- `404` — Entity was not found
- `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/35fe01ca087b/schema)
