---
title: "List Financial Transactions"
method: GET
path: "/v1/financial-transactions"
tags: ["Financial Transaction"]
---

# List Financial Transactions

`GET /v1/financial-transactions`

Retrieves a list of financial transactions.

## Query parameters

- `financialAccountId` string, nullable — Filter transactions involving the specified financial account ID.
- `reference` string, nullable — Filter by Monime-assigned transaction reference. Useful for retrieving all transactions grouped under the same reference identifier.
- `type` 'credit' | 'debit', nullable — Filter transactions by type: 'credit' for incoming funds or 'debit' for outgoing ones.
- `limit` integer — Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.
- `after` string, nullable — Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

## Headers

- `Monime-Space-Id` string, required — The value is the tenancy parameter that Monime uses to determine which space the request is intended for.
- `Monime-Version` 'caph.2025-08-23' | 'caph.2025-06-20', nullable — Specifies which version of the Monime API will handle this request.

## Response `200`

OK

- object
  - `success` boolean — Represents the status of the query operation, confirming if it was successful. This field is always true
  - `messages` unknown[] — Contains a list of messages providing relevant information or feedback related to the query or operation
    - unknown
  - `result` FinancialTransaction[], nullable — The list of items in the response
    - `id` string — Unique identifier for this financial transaction.
    - `type` 'credit' | 'debit' — Indicates whether the transaction is a 'credit' or 'debit'.
    - `amount` object — The monetary value involved in this transaction.
      - `currency` string — The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO currency code. Currently supported: 'SLE'
      - `value` integer — The value representation in the currency's minor unit. E.g. For 1 Leone (SLE 1), the value should be 100, denoting cents, the minor unit.
    - `timestamp` string, date-time — The exact time when this transaction was recorded.
    - `reference` string, nullable — Internal identifier associated with this transaction for reconciliation purposes.
    - `financialAccount` object — The account that was debited or credited as part of this transaction, including post-transaction balance snapshot.
      - `id` string — **Account ID**: Unique identifier of the financial account affected by this transaction.
      - `balance` object, nullable — **Account balance**: Balance snapshot of the account immediately after the transaction, if available.
        - `after` object — **Post-transaction balance**: The available balance of the account immediately after this transaction completed.
          - `currency` string — The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO currency code. Currently supported: 'SLE'
          - `value` integer — The value representation in the currency's minor unit. E.g. For 1 Leone (SLE 1), the value should be 100, denoting cents, the minor unit.
    - `originatingReversal` object, nullable — Indicates that this transaction was created as the result of a reversal action. The transaction itself represents the reversal of fund.
      - `originTxnId` string — The ID of the transaction that was reversed by this transaction
      - `originTxnRef` string — The reference of the transaction that was reversed by this transaction
    - `originatingFee` object, nullable — Indicates that this transaction was created as the result of an internal platform fee. The transaction itself represents the fee.
      - `code` string — The type of charge applied.
    - `ownershipGraph` object, nullable — Traceability structure showing which resource or object owns or initiated this transaction.
      - `owner` object — **Immediate object** that owns this entity. This is the direct originator or source object.
        - `id` string — **Unique ID** of the object instance that owns this entity.
        - `type` string — **Type of the object** that owns this entity. Examples include: 'internal_transfer', 'checkout_session', 'payment_code'.
        - `metadata` object, nullable — **Arbitrary metadata** describing the owning object.
        - `owner` CoreresourcesParentOwningObject
          - `id` string — **Unique ID** of the object instance that owns this entity.
          - `type` string — **Type of the object** that owns this entity. Examples include: 'internal_transfer', 'checkout_session', 'payment_code'.
          - `metadata` object, nullable — **Arbitrary metadata** describing the owning object.
          - `owner` CoreresourcesParentOwningObject — recursive
    - `metadata` object, nullable — Custom structured key-value pairs associated with this transaction for additional context.
  - `pagination` object — The pagination info associated with the response
    - `count` integer — Number of items returned in the current page.
    - `next` string, nullable — Cursor pointing to the next page of results. Use this value as the 'after' query parameter in your next request to fetch the following page. If null, you have reached the end of the result set.

---

[API](https://skmtc.dev/monime/apis/monime-api.md) · [All operations](https://skmtc.dev/monime/apis/monime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monime/monime-api/revisions/bd7f875ea428/schema)