> ## 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 Accounts > Retrieves list of financial accounts. ## OpenAPI ````yaml get /v1/financial-accounts 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-accounts: get: tags: - Financial Account summary: List Financial Accounts description: Retrieves list of financial accounts. operationId: ListFinancialAccounts parameters: - name: uvan in: query description: >- Filter by Universal Virtual Account Number (UVAN), a unique alias for the financial account. schema: maxLength: 16 type: string description: >- Filter by Universal Virtual Account Number (UVAN), a unique alias for the financial account. nullable: true - name: reference in: query description: >- Filter by external reference ID used to link the account with your internal system. schema: maxLength: 64 type: string description: >- Filter by external reference ID used to link the account with your internal system. nullable: true - name: withBalance in: query description: >- If true, includes the balance of the financial accounts in the response. schema: type: boolean description: >- If true, includes the balance of the financial accounts in the response. - 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/FinancialAccount' 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: FinancialAccount: title: Financial Account type: object properties: id: type: string description: Unique identifier of the financial account. uvan: type: string description: >- __UVAN__ (Universal Virtual Account Number) — a unique, checksum alias used for secure, error-resistant inbound transfers across Monime and external providers. name: type: string description: >- Human-readable label for the financial account, such as 'Main Wallet' or 'Operations Reserve'. currency: type: string description: >- ISO 4217 currency code (e.g., 'SLE', 'USD') indicating the account's currency. reference: type: string description: >- Optional external reference ID for this account (e.g., the account's identifier in your internal system). Must be unique across accounts. Useful for reconciliation, tracking, or cross-system mapping. nullable: true description: type: string description: Optional description of the account's purpose or usage context. nullable: true balance: type: object properties: available: 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 amount of funds currently available for use or withdrawal. description: Current available balance of the financial account. nullable: true createTime: type: string description: Timestamp when the financial account was created. format: date-time updateTime: type: string description: Timestamp when the financial account was last modified. 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: Updated metadata for storing additional context about the account. nullable: true description: "A **Financial Account** is a logical wallet or ledger unit that holds and tracks money for a user or entity. \nIt represents a balance in a specific currency and serves as the foundation for all money movement within Monime.\n\nEach account is uniquely identifiable, has a human-friendly display name (e.g., **“Main Wallet”**), and is always tied to a single currency such as **SLE** or **USD**. \n\nIn APIs, Financial Accounts act as the **source** or **destination** of funds for transfers, payouts, or collections.\n\n---\n\n### Use Cases\n\n- **Embedded Finance** \n\tWith **Embedded Finance on Monime**, fintechs can create **dynamic wallet accounts** hosted directly on Monime’s infrastructure. \n\tIncoming collections from **cards, Mobile Money, or banks** are deposited into these accounts, which can then be used for **spend, cash-out, or peer-to-peer (P2P) transfers** by moving funds between accounts.\n\t*Example* : Payments received through **Checkout Sessions** are credited to a user’s wallet account and can later be transferred to another user’s wallet, enabling seamless P2P experiences.\n\n- **Settlement Account** \n Businesses separate collected funds from the account used to settle merchants or subsidiaries. \n *Example*: A PSP routes daily Mobile Money collections into a **Settlement Account** before initiating payouts. \n\n- **Disbursement Float** \n A pre-funded account maintained to ensure outgoing transfers and payouts can always be covered. \n *Example*: Your platform maintains a **Disbursement Float** account; when it runs low, you top it up via an Internal Transfer. \n\n- **Dedicated Currency Account** \n Multi-currency platforms maintain one account per supported currency. \n *Example*: A customer has both a **USD Account** and an **SLE Account**, ensuring currency isolation and easier reconciliation.\n\n---\n" securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: auth-scheme description: >- Bearer HTTP authentication specified with the header Authorization: Bearer ````