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

# List Merchants

> Retrieve a list of all merchants associated with your company and their current balances.

### Headers

<ParamField header="x-api-key" type="string" required>
  Your test or live SDK Secret Key (`sk_test_...` or `sk_live_...`).
</ParamField>

### Response Fields

<ResponseField name="merchants" type="array">
  <Expandable title="Merchant Item">
    <ResponseField name="id" type="string">
      Unique identifier for the merchant (e.g., `mch_abc123`).
    </ResponseField>

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

    <ResponseField name="email" type="string">
      The merchant's contact email.
    </ResponseField>

    <ResponseField name="wallet_address" type="string">
      The USDC wallet address provisioned for this merchant on Base.
    </ResponseField>

    <ResponseField name="balance" type="string">
      Current USDC balance of the merchant's wallet.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the merchant account was created.
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Example

```json theme={null}
{
  "merchants": [
    {
      "id": "mch_abc123",
      "name": "Coffee Haven",
      "email": "owner@coffeehaven.com",
      "wallet_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "balance": "150.50",
      "created_at": "2026-03-28T22:33:53Z"
    },
    {
      "id": "mch_def456",
      "name": "The Juice Bar",
      "email": "billing@juicebar.io",
      "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
      "balance": "85.20",
      "created_at": "2026-03-29T10:15:00Z"
    }
  ]
}
```