---
title: "List Internal Transfers"
method: GET
path: "/v1/internal-transfers"
tags: ["Internal Transfer"]
---

# List Internal Transfers

`GET /v1/internal-transfers`

Retrieves a list of internal fund transfers between financial accounts within the Monime ecosystem.

## Query parameters

- `status` 'pending' | 'processing' | 'failed' | 'completed', nullable — Filters transfers by status: 'pending' (awaiting processing), 'processing' (in progress), 'failed' (attempt unsuccessful), or 'completed' (successfully transferred).
- `sourceFinancialAccountId` string, nullable — Source financial account ID. Filters results to transfers originating from this account.
- `destinationFinancialAccountId` string, nullable — Destination financial account ID. Filters results to transfers credited to this account.
- `financialTransactionReference` string, nullable — Financial transaction reference. Filters results to transfers with this transaction reference. Useful for correlation with underlying financial transactions.
- `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` InternalTransfer[], nullable — The list of items in the response
    - `id` string — Unique identifier for this transfer object.
    - `status` 'pending' | 'processing' | 'failed' | 'completed' — Current status of the transfer: - 'pending': Created but not yet processed. - 'processing': Currently being processed. - 'failed': Transfer failed. - 'completed': Transfer successfully completed.
    - `amount` object — Amount to be transferred from the source to the destination account.
      - `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.
    - `sourceFinancialAccount` object — Source financial account from which the funds will be debited.
      - `id` string — Unique identifier for the financial account
    - `destinationFinancialAccount` object — Destination financial account to which the funds will be credited.
      - `id` string — Unique identifier for the financial account
    - `financialTransactionReference` string, nullable — Reference to the resulting financial transaction(s), if the transfer was completed.
    - `description` string, nullable — Human-readable description of the transfer. Useful for developer context, admin UIs, or logs.
    - `failureDetail` object, nullable — Failure details, populated only when the transfer status is 'failed'.
      - `code` 'unknown' | 'fund_insufficient' — **Error code** representing the reason this transfer failed. Possible values include: - **unknown**: Generic or unclassified failure. - **fund_insufficient**: Not enough funds in the source account.
      - `message` string, nullable — **Optional explanation** providing more context about the failure. Useful for developer logs or end-user display.
    - `ownershipGraph` object, nullable — Ownership chain that shows which object or action triggered the transfer — enabling audit traceability.
      - `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
    - `createTime` string, date-time — Timestamp indicating when the transfer was created.
    - `updateTime` string, date-time, nullable — Timestamp of the most recent update to the transfer.
    - `metadata` object, nullable — Custom metadata for tagging this transfer with additional context or identifiers.
  - `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)