> ## 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.

# Get Financial Transaction

> Retrieves the details of a financial transaction, including its type, amount, source account, and ownership trace.



## OpenAPI

````yaml get /v1/financial-transactions/{id}
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/{id}:
    get:
      tags:
        - Financial Transaction
      summary: Get Financial Transaction
      description: >-
        Retrieves the details of a financial transaction, including its type,
        amount, source account, and ownership trace.
      operationId: GetTransaction
      parameters:
        - name: id
          in: path
          description: Unique identifier of the financial transaction to retrieve.
          required: true
          schema:
            pattern: ^txn-.*$
            type: string
            description: Unique identifier of the financial transaction to retrieve.
        - 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
        - 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.
      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:
                    $ref: '#/components/schemas/FinancialTransaction'
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 <access_token>

````