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

> Retrieve a single merchant by its UUID, including its name, settings, and configuration. Supports Bearer token and API key authentication.

The Get Merchant endpoint returns the details for a single merchant identified by its UUID. Use this endpoint to read merchant configuration, verify settings, or fetch metadata before performing operations on the merchant.

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

## 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 to retrieve.
</ParamField>

## Response fields

<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="settings" type="object">
  Merchant-level configuration settings.

  <Expandable title="properties">
    <ResponseField name="webhookUrl" type="string">
      The URL IteraPay sends webhook events to for this merchant.
    </ResponseField>

    <ResponseField name="ipWhitelist" type="string[]">
      List of allowed IP addresses for API key requests.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example request

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

## Example response

```json theme={null}
{
  "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f",
  "name": "My Store",
  "settings": {
    "webhookUrl": "https://mystore.example.com/webhooks/iterapay",
    "ipWhitelist": ["203.0.113.42"]
  }
}
```

## Error responses

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