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

# Merchant customers

> List customers and adjust store credit with a Bearer API key.

```http theme={null}
GET   /api/merchant/v1/stores/{storeId}/customers?page=1&limit=50
GET   /api/merchant/v1/stores/{storeId}/customers/{customerKey}
PATCH /api/merchant/v1/stores/{storeId}/customers/{customerKey}/balance
```

Scopes: `customer:read` · `customer:balance:write` · ceiling `viewCustomers`

`customerKey` is the base64url encoding of the lowercase email (the `key` field on list rows).

Balance body:

```json theme={null}
{ "type": "add", "amount": 5, "note": "Goodwill credit" }
```

`type` is `add`, `subtract`, or `set`. Path `storeId` wins over any body `storeId`.

## Related

* [API keys](/developers/api-keys)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.