> ## 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. # Create Financial Account > Creates a new financial account for holding or managing funds within a Space. ## OpenAPI ````yaml post /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: post: tags: - Financial Account summary: Create Financial Account description: >- Creates a new financial account for holding or managing funds within a Space. operationId: CreateFinancialAccount parameters: - name: Idempotency-Key in: header description: >- This header is used to uniquely identify a logical request, ensuring that it is not processed more than once during retries. required: true schema: maxLength: 64 type: string description: >- This header is used to uniquely identify a logical request, ensuring that it is not processed more than once during retries. - 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. requestBody: content: application/json: schema: title: CreateFinancialAccount required: - name - currency type: object properties: name: maxLength: 100 type: string description: >- Label for the financial account, e.g., 'Main Wallet' or 'Reserved Account'. currency: type: string description: >- ISO 4217 currency code (e.g., 'SLE', 'USD') indicating the account's currency. reference: maxLength: 64 type: string description: >- Optional external reference ID for this account. Must be unique across financial accounts in the same Space. nullable: true description: maxLength: 150 type: string description: Optional note about the account’s usage or purpose. 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 additionalProperties: false description: >- Creates a new financial account for holding or managing funds within a Space. 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/FinancialAccount' 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 ````