> ## 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 Financial Transactions > Retrieves a list of financial transactions. ## OpenAPI ````yaml get /v1/financial-transactions 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/financial-transactions: get: tags: - Financial Transaction summary: List Financial Transactions description: Retrieves a list of financial transactions. operationId: ListFinancialTransactions parameters: - name: financialAccountId in: query description: Filter transactions involving the specified financial account ID. schema: type: string description: Filter transactions involving the specified financial account ID. nullable: true - name: reference in: query description: >- Filter by Monime-assigned transaction reference. Useful for retrieving all transactions grouped under the same reference identifier. schema: type: string description: >- Filter by Monime-assigned transaction reference. Useful for retrieving all transactions grouped under the same reference identifier. nullable: true - name: type in: query description: >- Filter transactions by type: 'credit' for incoming funds or 'debit' for outgoing ones. schema: enum: - credit - debit type: string description: >- Filter transactions by type: 'credit' for incoming funds or 'debit' for outgoing ones. 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/FinancialTransaction' 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: FinancialTransaction: title: Financial Transaction type: object properties: id: type: string description: Unique identifier for this financial transaction. type: enum: - credit - debit type: string description: Indicates whether the transaction is a 'credit' or 'debit'. 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: The monetary value involved in this transaction. timestamp: type: string description: The exact time when this transaction was recorded. format: date-time reference: type: string description: >- Internal identifier associated with this transaction for reconciliation purposes. nullable: true financialAccount: title: Financial Account type: object properties: id: type: string description: >- **Account ID**: Unique identifier of the financial account affected by this transaction. readOnly: true balance: title: Financial Account Balance type: object properties: after: 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: >- **Post-transaction balance**: The available balance of the account immediately after this transaction completed. additionalProperties: false description: >- **Account balance**: Balance snapshot of the account immediately after the transaction, if available. nullable: true readOnly: true additionalProperties: false description: >- The account that was debited or credited as part of this transaction, including post-transaction balance snapshot. originatingReversal: type: object properties: originTxnId: type: string description: The ID of the transaction that was reversed by this transaction originTxnRef: type: string description: >- The reference of the transaction that was reversed by this transaction additionalProperties: false description: >- Indicates that this transaction was created as the result of a reversal action. The transaction itself represents the reversal of fund. nullable: true originatingFee: type: object properties: code: type: string description: The type of charge applied. additionalProperties: false description: >- Indicates that this transaction was created as the result of an internal platform fee. The transaction itself represents the fee. 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: >- Traceability structure showing which resource or object owns or initiated this transaction. 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 structured key-value pairs associated with this transaction for additional context. nullable: true description: > A **Financial Transaction** represents a movement of funds that affects a Financial Account, either as a **credit** (inflow) or a **debit** (outflow). Every transaction adjusts the balance of an account and provides a full audit trail of how money moves within Monime. --- ### Use Cases - **Customer Payment Recording** A user pays SLE 500 into your platform via Mobile Money. *Result*: A **credit transaction** is posted to a financial account of the space; this transaction is linked to a **Payment** created from the originating **Payment Code**. - **Fee Deduction** A SLE 50 fee is charged for a payout of SLE 1,000. *Result*: - A **debit transaction** of SLE 1,000 from the payout account. - A **debit transaction** of SLE 50 from the payout account. - **Internal Transfer** Moving SLE 10,000 from a Settlement Account to a Disbursement Float. *Result*: - A **debit transaction** on the Settlement Account. - A **credit transaction** on the Disbursement Float Account. - **Refund or Reversal** If a payment is refunded, a corresponding **debit transaction** reduces the merchant’s balance. *Result*: The audit trail shows both the original credit and the refund debit, linked together. --- 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 ````