---
title: "Retrieve a Merchant Settlement Account by ID"
method: GET
path: "/v1/accounts/{accountId}"
tags: ["Settlement Accounts"]
---

# Retrieve a Merchant Settlement Account by ID

`GET /v1/accounts/{accountId}`

The **Retrieve a Merchant Settlement Account** endpoint allows you to fetch details of an existing merchant settlement account using the account's unique ID. This includes all account information such as account type, supported currencies, blockchain details, and status. Use this endpoint to view specific account configurations and verify account details within BoomFi.

## Path parameters

- `accountId` integer, required

## Response `200`

Successfully retrieves the merchant settlement account.

- Account
  - `data` AccountDetails
    - `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.
  - `message` string — A message indicating the result of the operation.

## Other responses

- `404` — The specified merchant settlement account does not exist.

---

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