---
title: "List Merchant Settlement Accounts"
method: GET
path: "/v1/accounts"
tags: ["Settlement Accounts"]
---

# List Merchant Settlement Accounts

`GET /v1/accounts`

The **List Merchant Settlement Accounts** endpoint allows you to retrieve all merchant settlement accounts associated with your organization. This includes detailed information such as account IDs, types, supported currencies, and blockchain network details. Use this endpoint to view and manage your merchant settlement accounts, ensuring they are configured correctly in BoomFi.

## Query parameters

- `reference` string, string — The reference identifier of the merchant settlement account.

## Response `200`

Successfully retrieves a list of the merchant settlement accounts.

- Accounts — The response schema for listing multiple merchant settlement accounts.
  - `data` object — The data container for the list of accounts.
    - `items` AccountDetails[] — A list of merchant settlement accounts.
      - `id` integer — A unique identifier for the merchant settlement account.
      - `org_id` string — The unique identifier of your organization.
      - `parent_id` integer, nullable — The identifier of the parent merchant settlement account, if applicable.
      - `reference` string — A reference code to group and manage multiple merchant settlement accounts.
      - `account_type` 'CryptoPayIn' | 'CryptoPayOut' | 'FiatPayIn' | 'FiatPayOut' | 'Crypto' | 'Bank' | 'Card' | 'MPCVault' | 'GooglePay' | 'ApplePay' — The type of merchant settlement account, indicating the settlement method.
      - `name` string — The name assigned to the merchant settlement account.
      - `chain_id` integer — The blockchain network identifier (e.g., 1 for Ethereum Mainnet, 8453 for Base Mainnet).
      - `address` string — The wallet address associated with the merchant settlement account.
      - `currencies` string[] — A list of currency codes that the account supports. Possible values are: - **ETH**: Ethereum - **USDC**: USD Coin - **USDT**: Tether - **WETH**: Wrapped Ether - **DAI**: Dai Stablecoin - **SOL**: Solana Ensure that the currencies listed are supported by the account's blockchain network and are relevant to your transaction needs.
      - `account_number` string — The account number for fiat settlement accounts. Empty if not applicable.
      - `sort_code` string — The bank sort code for fiat settlement accounts. Empty if not applicable.
      - `enabled` boolean — Indicates whether this merchant settlement account is currently enabled.
      - `state` 'Unknown' | 'Pending' | 'Ready' — The current state of the merchant settlement account.
      - `created_by` string — The identifier of the user who created this account.
      - `created_at` string, date-time — The timestamp when the merchant settlement account was created.
      - `updated_at` string, date-time — The timestamp when the merchant settlement account was last updated.
      - `deleted_at` string, date-time, nullable — The timestamp when the merchant settlement account was deleted, if applicable.

## Other responses

- `404` — No merchant settlement accounts found for the provided criteria.

---

[API](https://skmtc.net/boomfi/apis/boomfi-merchants-api.md) · [All operations](https://skmtc.net/boomfi/apis/boomfi-merchants-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/boomfi/boomfi-merchants-api/revisions/ace3c3df05fe/schema)