> ## 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 Limits — GET /merchants/{merchantID}/limits

> Retrieve the minimum transaction limits for collect and withdrawal operations for a merchant. Requires Bearer token authentication.

The Get Merchant Limits endpoint returns the minimum amounts required for collect and withdrawal operations on a merchant account. Check these limits before initiating either operation to avoid rejected requests due to insufficient amounts.

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

## Authentication

Requires a Bearer token (`Authorization: Bearer <token>`). API key authentication is not accepted for this endpoint.

## Path parameters

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

## Response fields

<ResponseField name="minCollect" type="string" required>
  The minimum amount required to initiate a collect operation, as a decimal string (e.g., `"10.00"`).
</ResponseField>

<ResponseField name="minWithdraw" type="string" required>
  The minimum amount required to initiate a withdrawal, as a decimal string (e.g., `"5.00"`).
</ResponseField>

## Example request

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

## Example response

```json theme={null}
{
  "minCollect": "10.00",
  "minWithdraw": "5.00"
}
```

<Info>
  Limits are set at the platform level and may vary depending on your merchant's configured payment methods. Contact support if you need your limits reviewed.
</Info>

## Error responses

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