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

# Get Merchant Details

> Fetch single merchant profile, withdrawable balance, and active POS terminal device specs.

### Headers

<ParamField header="x-api-key" type="string" required>
  Your test or live SDK API key (`pk_test_...` or `pk_live_...`).
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  Unique merchant identifier (e.g., `mer_cm6abc123`).
</ParamField>

### Response Fields

<ResponseField name="merchant" type="object">
  <Expandable title="Merchant Object">
    <ResponseField name="id" type="string">
      Unique Merchant ID.
    </ResponseField>

    <ResponseField name="name" type="string">
      Merchant display name.
    </ResponseField>

    <ResponseField name="email" type="string">
      Merchant account email.
    </ResponseField>

    <ResponseField name="wallet_address" type="string">
      Privy embedded wallet address.
    </ResponseField>

    <ResponseField name="balance" type="string">
      Current net withdrawable USDC balance.
    </ResponseField>

    <ResponseField name="status" type="string">
      Merchant status: `ACTIVE`, `PAUSED`, `FROZEN`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 creation timestamp.
    </ResponseField>

    <ResponseField name="device" type="object">
      Primary active POS terminal specs (`device_uuid`, `public_key`, `model`, `platform`, `os_version`, `app_version`).
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Example

```json theme={null}
{
  "merchant": {
    "id": "mer_cm6abc123",
    "name": "Corner Bakery",
    "email": "pos@bakery.com",
    "wallet_address": "0x456...def",
    "balance": "1250.500000",
    "status": "ACTIVE",
    "created_at": "2026-08-01T10:00:00.000Z",
    "device": {
      "id": "dev_789",
      "device_uuid": "uuid_e4d9b6...",
      "public_key": "0xEd25519PublicKey...",
      "model": "PAX A920",
      "platform": "android",
      "os_version": "Android 14",
      "app_version": "1.2.0",
      "status": "ACTIVE"
    }
  }
}
```