Sign in

v3

latestOpenAPI 3.0.3UNLICENSED2026-07-2796235396.3 KB
ledger-account activity

Get a single sub-account transaction activity

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

get/ledger/subaccounts/{subAccountIdRef}/activities/{activityId}

Path parameters

subAccountIdRefstring required

The unique onboard sub-account ID or reference

activityIdstring uuid required

The unique transaction activity ID

Response

Activity fetched successfully

idstring uuid required
activityTypestring 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
amountnumber required

Always positive; see direction for credit/debit.

currencystring 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.
referencestring

Customer-facing reference of the source transaction.

accountIdstring uuid required
accountType'MAIN' | 'SUB_ACCOUNT' | 'OFFRAMP_ACCOUNT' required

The kind of account a transaction activity occurred on.

subAccountIdstring uuid

Set when accountType is SUB_ACCOUNT.

accountTransactionIdstring

Identifier of the transaction on the ledger account, when available.

groupIdstring uuid

Links related activities together, e.g. the two legs of an internal transfer, or an offramp deposit and its refund.

narrationstring
activityAtstring date-time required

Example response

{
  "amount": 100,
  "currency": "USD"
}