> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iterapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Merchants — GET /merchants

> Retrieve all merchants your credentials have access to, including each merchant's current balances across supported payment methods.

The List Merchants endpoint returns all merchants associated with your credentials along with their current balances. Use this endpoint to display an overview of all your merchant accounts or to check balance positions across payment methods.

**`GET /merchants`**

## Authentication

Accepts a Bearer token (`Authorization: Bearer <token>`) or an API key (`X-Api-Key: <key>`).

## Response fields

The endpoint returns an array of merchant objects.

<ResponseField name="id" type="string" required>
  The merchant's unique identifier (UUID).
</ResponseField>

<ResponseField name="name" type="string" required>
  The merchant's display name.
</ResponseField>

<ResponseField name="balances" type="object[]" required>
  A list of balance entries, one per payment method.

  <Expandable title="properties">
    <ResponseField name="paymentMethodID" type="integer" required>
      The identifier for the payment method (cryptocurrency).
    </ResponseField>

    <ResponseField name="balance" type="string" required>
      The available balance as a decimal string (e.g., `"1.50000000"`).
    </ResponseField>

    <ResponseField name="symbol" type="string" required>
      The token symbol (e.g., `"USDT"`, `"ETH"`).
    </ResponseField>
  </Expandable>
</ResponseField>

## Example request

```bash theme={null}
curl --request GET \
  --url https://api.iterapay.com/merchants \
  --header 'Authorization: Bearer <token>'
```

## Example response

```json theme={null}
[
  {
    "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f",
    "name": "My Store",
    "balances": [
      {
        "paymentMethodID": 1,
        "balance": "250.00000000",
        "symbol": "USDT"
      },
      {
        "paymentMethodID": 2,
        "balance": "0.04150000",
        "symbol": "ETH"
      }
    ]
  },
  {
    "id": "e2d1a4f6-88bc-4a91-b3e7-1c9f20d84b52",
    "name": "Second Store",
    "balances": [
      {
        "paymentMethodID": 1,
        "balance": "0.00000000",
        "symbol": "USDT"
      }
    ]
  }
]
```

## Error responses

| Status | Description                                     |
| ------ | ----------------------------------------------- |
| `401`  | Missing or invalid credentials.                 |
| `403`  | Valid credentials but insufficient permissions. |