> ## Documentation Index > Fetch the complete documentation index at: https://docs.monime.io/llms.txt > Use this file to discover all available pages before exploring further. # List Internal Transfers > Retrieves a list of internal fund transfers between financial accounts within the Monime ecosystem. ## OpenAPI ````yaml get /v1/internal-transfers openapi: 3.0.3 info: title: Monime API description: Monime REST API. Please visit https://docs.momime.io/api for more details. termsOfService: https://monime.io/legal/terms-of-service contact: name: Monime Developers url: https://github.com/monimesl email: dev@monime.io version: v1 servers: - url: https://api.monime.io/ security: - bearerAuth: [] paths: /v1/internal-transfers: get: tags: - Internal Transfer summary: List Internal Transfers description: >- Retrieves a list of internal fund transfers between financial accounts within the Monime ecosystem. operationId: ListInternalTransfers parameters: - name: status in: query description: >- Filters transfers by status: 'pending' (awaiting processing), 'processing' (in progress), 'failed' (attempt unsuccessful), or 'completed' (successfully transferred). schema: enum: - pending - processing - failed - completed type: string description: >- Filters transfers by status: 'pending' (awaiting processing), 'processing' (in progress), 'failed' (attempt unsuccessful), or 'completed' (successfully transferred). nullable: true - name: sourceFinancialAccountId in: query description: >- Source financial account ID. Filters results to transfers originating from this account. schema: type: string description: >- Source financial account ID. Filters results to transfers originating from this account. nullable: true - name: destinationFinancialAccountId in: query description: >- Destination financial account ID. Filters results to transfers credited to this account. schema: type: string description: >- Destination financial account ID. Filters results to transfers credited to this account. nullable: true - name: financialTransactionReference in: query description: >- Financial transaction reference. Filters results to transfers with this transaction reference. Useful for correlation with underlying financial transactions. schema: type: string description: >- Financial transaction reference. Filters results to transfers with this transaction reference. Useful for correlation with underlying financial transactions. nullable: true - name: limit in: query description: >- Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified. schema: maximum: 50 minimum: 1 type: integer description: >- Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified. default: 10 - name: after in: query description: >- Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward. schema: maxLength: 2000 type: string description: >- Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward. nullable: true - name: Monime-Space-Id in: header description: >- The value is the tenancy parameter that Monime uses to determine which space the request is intended for. required: true schema: maxLength: 64 pattern: ^spc-.*$ type: string description: >- The value is the tenancy parameter that Monime uses to determine which space the request is intended for. - name: Monime-Version in: header description: Specifies which version of the Monime API will handle this request. schema: enum: - caph.2025-08-23 - caph.2025-06-20 type: string description: >- Specifies which version of the Monime API will handle this request. nullable: true responses: '200': description: OK content: application/json: schema: type: object properties: success: type: boolean description: >- Represents the status of the query operation, confirming if it was successful. This field is always true messages: type: array items: {} description: >- Contains a list of messages providing relevant information or feedback related to the query or operation result: type: array items: $ref: '#/components/schemas/InternalTransfer' description: The list of items in the response nullable: true pagination: type: object properties: count: type: integer description: Number of items returned in the current page. next: type: string description: >- 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. nullable: true description: The pagination info associated with the response components: schemas: InternalTransfer: title: Internal Transfer type: object properties: id: type: string description: Unique identifier for this transfer object. status: enum: - pending - processing - failed - completed type: string description: |- Current status of the transfer: - 'pending': Created but not yet processed. - 'processing': Currently being processed. - 'failed': Transfer failed. - 'completed': Transfer successfully completed. amount: type: object properties: currency: type: string description: >- The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO currency code. Currently supported: 'SLE' value: type: integer description: >- 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. additionalProperties: false description: Amount to be transferred from the source to the destination account. sourceFinancialAccount: type: object properties: id: type: string description: Unique identifier for the financial account additionalProperties: false description: Source financial account from which the funds will be debited. destinationFinancialAccount: type: object properties: id: type: string description: Unique identifier for the financial account additionalProperties: false description: Destination financial account to which the funds will be credited. financialTransactionReference: type: string description: >- Reference to the resulting financial transaction(s), if the transfer was completed. nullable: true description: type: string description: >- Human-readable description of the transfer. Useful for developer context, admin UIs, or logs. nullable: true failureDetail: type: object properties: code: enum: - unknown - fund_insufficient type: string description: >- **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: type: string description: >- **Optional explanation** providing more context about the failure. Useful for developer logs or end-user display. nullable: true description: >- Failure details, populated only when the transfer status is 'failed'. nullable: true ownershipGraph: title: OwnershipGraph type: object properties: owner: title: OwnershipObject type: object properties: id: type: string description: '**Unique ID** of the object instance that owns this entity.' readOnly: true type: type: string description: >- **Type of the object** that owns this entity. Examples include: 'internal_transfer', 'checkout_session', 'payment_code'. readOnly: true metadata: maxProperties: 64 type: object additionalProperties: maxLength: 100 type: string description: >- Metadata values are free-form strings up to 100 characters. description: '**Arbitrary metadata** describing the owning object.' nullable: true readOnly: true owner: $ref: '#/components/schemas/CoreresourcesParentOwningObject' additionalProperties: false description: >- **Immediate object** that owns this entity. This is the direct originator or source object. readOnly: true additionalProperties: false description: >- Ownership chain that shows which object or action triggered the transfer — enabling audit traceability. nullable: true createTime: type: string description: Timestamp indicating when the transfer was created. format: date-time updateTime: type: string description: Timestamp of the most recent update to the transfer. format: date-time nullable: true metadata: maxProperties: 64 type: object additionalProperties: maxLength: 100 type: string description: Metadata values are free-form strings up to 100 characters. description: >- Custom metadata for tagging this transfer with additional context or identifiers. nullable: true description: >- An **Internal Transfer** is the movement of funds between financial accounts that exist within the same Space. Unlike payouts or customer payments that cross external networks (banks, card schemes, or mobile money), an Internal Transfer happens entirely within Monime’s ledger. It is the mechanism for shifting balances between accounts you own or manage, and it never leaves your organization’s financial boundary. --- ### Use Cases - **Wallet Top-ups** A customer wallet account can be funded by moving money from your master operational account. *Example*: A user adds **SLE 1,000** to their app wallet. Your backend issues an Internal Transfer from your **Operational Float** to the user’s **Wallet Account**. - **Inter-Account Routing** Businesses often separate funds for accounting clarity (e.g., “Card Collections,” “Mobile Money Collections,” “Bank Transfers”). *Example*: At the end of each day, you route all **Mobile Money collections** into a central **Settlement Account**. - **Internal Settlements** Useful when multiple departments or sub-entities operate under one Space. *Example*: Subsidiary A owes Subsidiary B **SLE 50,000**. Instead of moving money through the banking system, you perform an Internal Transfer inside your Monime ledger. - **Float Management** Fintechs maintain float across accounts to support disbursements. *Example*: If your **Disbursement Account** is running low, you move funds from your **Collection Account** to top it up before processing payouts. --- CoreresourcesParentOwningObject: title: OwnershipObject type: object properties: id: type: string description: '**Unique ID** of the object instance that owns this entity.' readOnly: true type: type: string description: >- **Type of the object** that owns this entity. Examples include: 'internal_transfer', 'checkout_session', 'payment_code'. readOnly: true metadata: maxProperties: 64 type: object additionalProperties: maxLength: 100 type: string description: Metadata values are free-form strings up to 100 characters. description: '**Arbitrary metadata** describing the owning object.' nullable: true readOnly: true owner: $ref: '#/components/schemas/CoreresourcesParentOwningObject' additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: auth-scheme description: >- Bearer HTTP authentication specified with the header Authorization: Bearer ````