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

# Get a single transaction activity

`GET /ledger/accounts/{accountId}/activities/{activityId}`

## Request

- Base URL: `https://external.dev.onboardpay.co`
- URL: `https://external.dev.onboardpay.co/ledger/accounts/{accountId}/activities/{activityId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/docs/ledger/accounts/:accountId/activities/:activityId/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Path parameters

- `accountId` string, uuid, 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' | 'DEPOSIT_REVERSAL', 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' | 'CARD_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
  - `underReview` boolean: True while the funds of this deposit are held for review: they can't be used until the review is complete. Absent for activities that are not under review.

## 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

## Changes

- **2026-10-29** `5da9ec1b2573`: 1 info
  - added the optional property `underReview` to the response with the `200` status
- **2026-10-26** `f177db874250`: 1 warning, 1 info
  - added the new `DEPOSIT_REVERSAL` enum value to the `type` response property for the response status `200`
  - added `DepositReversalActivity` mapping keys to the response discriminator for the response status `200`
- **2026-09-03** `1805362fe220`: 1 warning
  - added the new `CARD_ACCOUNT` enum value to the `accountType` response property for the response status `200`
- **2026-07-26** `a3c4e2742615`: 2 info
  - the endpoint scheme security `HMACAuth` was added to the API
  - the endpoint scheme security `authToken` was removed from the API
- **2026-07-13** `fc790ea4deb6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/changes/ledger/accounts/:accountId/activities/:activityId/get.md)

---

[API](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway.md) - [All operations](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/revisions/5da9ec1b2573?raw)