---
title: "Update Financial Account"
method: PATCH
path: "/v1/financial-accounts/{id}"
tags: ["Financial Account"]
---

# Update Financial Account

`PATCH /v1/financial-accounts/{id}`

Partially updates a financial account. Fields not included in the request body remain unchanged.

## Path parameters

- `id` string, required — The ID of the financial account to update.

## Headers

- `Monime-Version` 'caph.2025-08-23' | 'caph.2025-06-20', nullable — Specifies which version of the Monime API will handle this request.
- `Monime-Space-Id` string, required — The value is the tenancy parameter that Monime uses to determine which space the request is intended for.

## Request body

- object — Partially updates a financial account. Fields not included in the request body remain unchanged.
  - `name` string, nullable — Updated label for the financial account.
  - `reference` string, nullable — Updated external reference ID. Must be unique across accounts.
  - `description` string, nullable — Updated description of the account's purpose.
  - `metadata` object, nullable — Updated metadata for storing additional context about the account.

## 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` FinancialAccount — A **Financial Account** is a logical wallet or ledger unit that holds and tracks money for a user or entity. It represents a balance in a specific currency and serves as the foundation for all money movement within Monime. Each 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**. In APIs, Financial Accounts act as the **source** or **destination** of funds for transfers, payouts, or collections. --- ### Use Cases - **Embedded Finance** With **Embedded Finance on Monime**, fintechs can create **dynamic wallet accounts** hosted directly on Monime’s infrastructure. Incoming 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. *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. - **Settlement Account** Businesses separate collected funds from the account used to settle merchants or subsidiaries. *Example*: A PSP routes daily Mobile Money collections into a **Settlement Account** before initiating payouts. - **Disbursement Float** A pre-funded account maintained to ensure outgoing transfers and payouts can always be covered. *Example*: Your platform maintains a **Disbursement Float** account; when it runs low, you top it up via an Internal Transfer. - **Dedicated Currency Account** Multi-currency platforms maintain one account per supported currency. *Example*: A customer has both a **USD Account** and an **SLE Account**, ensuring currency isolation and easier reconciliation. ---
    - `id` string — Unique identifier of the financial account.
    - `uvan` string — __UVAN__ (Universal Virtual Account Number) — a unique, checksum alias used for secure, error-resistant inbound transfers across Monime and external providers.
    - `name` string — Human-readable label for the financial account, such as 'Main Wallet' or 'Operations Reserve'.
    - `currency` string — ISO 4217 currency code (e.g., 'SLE', 'USD') indicating the account's currency.
    - `reference` string, nullable — 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.
    - `description` string, nullable — Optional description of the account's purpose or usage context.
    - `balance` object, nullable — Current available balance of the financial account.
      - `available` object — The amount of funds currently available for use or withdrawal.
        - `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.
    - `createTime` string, date-time — Timestamp when the financial account was created.
    - `updateTime` string, date-time, nullable — Timestamp when the financial account was last modified.
    - `metadata` object, nullable — Updated metadata for storing additional context about the account.

---

[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)