---
title: "Get merchant account"
method: GET
path: "/v3/merchant-accounts/{id}"
tags: ["Merchant accounts"]
---

# Get merchant account

`GET /v3/merchant-accounts/{id}`

## Request

- Base URL: `https://api.truelayer-sandbox.com`
- URL: `https://api.truelayer-sandbox.com/v3/merchant-accounts/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.truelayer.com/connect/token` scopes: `payments`

Get the details of a single merchant account.

## Path parameters

- `id` string, uuid, required: Unique ID for the Merchant Account

## Response `200`

Merchant account.

- MerchantAccount
  - `id` string, uuid, required: Unique ID for the Merchant Account
  - `currency` 'GBP' | 'EUR' | 'PLN', required: The ISO 4217 code of the currency associated with the merchant account. Merchant accounts can only hold funds in a single currency.
  - `account_identifiers` AccountIdentifier[], required: The different identifiers you can use to route payments into this account over various payment schemes. These identifiers can be used as beneficiary details if you need to deposit funds into your merchant account via manual bank transfers. All end users payments into your account should be authorized via a payment with `merchant_account` as destination type.
    - union: A unique scheme identifier for an external account.
      - AccountIdentifierScan: The scheme identifier for a bank account participating in UK payment schemes.
        - `type` 'sort_code_account_number', required: The type of scheme identifier.
        - `sort_code` string, required: 6 digit sort code (no spaces or dashes). pattern: `^[0-9]{6}$`
        - `account_number` string, required: 8 digit account number. pattern: `^[0-9]{8}$`
      - AccountIdentifierIban: The international bank account number.
        - `type` 'iban', required: The type of scheme identifier.
        - `iban` string, required: Valid International Bank Account Number (no spaces). Consists of a 2 letter country code, followed by 2 check digits, and then by up to 30 alphanumeric characters (also known as the BBAN). pattern: `^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$`
      - AccountIdentifierNrb: The scheme identifier for a bank account participating in Poland's payment schemes.
        - `type` 'nrb', required: The type of scheme identifier.
        - `nrb` string, required: Valid Polish NRB (no spaces). Consists of 2 check digits, followed by an 8 digit bank branch number, and then by a 16 digit bank account number. Equivalent to a Polish IBAN with the country code removed.
  - `available_balance_in_minor` integer, required: The balance immediately available to perform payouts and transfers, expressed in the smallest denomination of the account's currency. The available balance does also take into consideration transactions that are not yet in a final state.
  - `current_balance_in_minor` integer, required: The current balance, expressed in the smallest denomination of the account's currency. The current balance does not take into consideration transactions that are not yet in a final state.
  - `account_holder_name` string, required: The name of the account holder. It must match your organisation's legal name.

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `404`: Account Not Found
- `500`: Unknown Error

---

[API](https://skmtc.dev/truelayer/apis/payments-api-v3.md) - [All operations](https://skmtc.dev/truelayer/apis/payments-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/payments-api-v3/revisions/a7c585fc9b84?raw)