> ## 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.

# Get Merchant Funds — GET /merchants/{merchantID}/funds

> Retrieve a merchant's available fund balances broken down by payment method. Each entry includes the balance amount and token symbol.

The Get Merchant Funds endpoint returns the available fund balances for a merchant, with one entry per payment method. Use this endpoint to check how much of each cryptocurrency is available before initiating a withdrawal or collect operation.

**`GET /merchants/{merchantID}/funds`**

## Authentication

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

## Path parameters

<ParamField path="merchantID" type="string" required>
  The UUID of the merchant whose funds you want to retrieve.
</ParamField>

## Response fields

The endpoint returns an array of fund balance objects, one per payment method.

<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., `"250.00000000"`).
</ResponseField>

<ResponseField name="symbol" type="string" required>
  The token symbol for this payment method (e.g., `"USDT"`, `"ETH"`, `"BTC"`).
</ResponseField>

## Example request

```bash theme={null}
curl --request GET \
  --url https://api.iterapay.com/merchants/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f/funds \
  --header 'Authorization: Bearer <token>'
```

## Example response

```json theme={null}
[
  {
    "paymentMethodID": 1,
    "balance": "250.00000000",
    "symbol": "USDT"
  },
  {
    "paymentMethodID": 2,
    "balance": "0.04150000",
    "symbol": "ETH"
  },
  {
    "paymentMethodID": 3,
    "balance": "0.00000000",
    "symbol": "BTC"
  }
]
```

<Note>
  Payment methods with a zero balance are included in the response. All supported payment methods for the merchant are always returned.
</Note>

## Error responses

| Status | Description                                     |
| ------ | ----------------------------------------------- |
| `401`  | Missing or invalid credentials.                 |
| `403`  | Valid credentials but insufficient permissions. |
| `404`  | No merchant found with the given `merchantID`.  |