---
title: "List Financial Accounts"
method: GET
path: "/v1/financial-accounts"
tags: ["Financial Account"]
---

# List Financial Accounts

`GET /v1/financial-accounts`

Retrieves list of financial accounts.

## Query parameters

- `uvan` string, nullable — Filter by Universal Virtual Account Number (UVAN), a unique alias for the financial account.
- `reference` string, nullable — Filter by external reference ID used to link the account with your internal system.
- `withBalance` boolean — If true, includes the balance of the financial accounts in the response.
- `limit` integer — Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.
- `after` string, nullable — Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

## Headers

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

## 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[], nullable — The list of items in the response
    - `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.
  - `pagination` object — The pagination info associated with the response
    - `count` integer — Number of items returned in the current page.
    - `next` string, nullable — 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.

---

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