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

# List subusers

> GET /api/reseller/v1/subusers: all subusers under your account

Retrieve every subuser under your reseller account.

## Authentication

Requires a reseller API key. Pass it as `Authorization: Bearer YOUR_API_KEY` or `X-API-Key: YOUR_API_KEY`. See [Reseller overview](/api/reseller/overview#authentication).

## Response

`data` is an array of subuser objects.

<ResponseField name="id" type="string">Internal subuser ID.</ResponseField>
<ResponseField name="username" type="string">Full username, prefixed with your store code.</ResponseField>
<ResponseField name="email" type="string">Subuser email.</ResponseField>
<ResponseField name="bandwidthBalance" type="number">Bandwidth allocated to the subuser (MB).</ResponseField>
<ResponseField name="createdAt" type="string">Creation timestamp (ISO 8601).</ResponseField>
<ResponseField name="whitelistIPs" type="array">Whitelisted IPs for the subuser.</ResponseField>

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": [
    {
      "id": "subuser-123",
      "username": "MYSTORE_user1",
      "email": "user1@example.com",
      "bandwidthBalance": 100,
      "createdAt": "2026-02-20T14:22:00Z",
      "whitelistIPs": ["192.168.1.1", "10.0.0.1"]
    }
  ]
}
```

## Errors

* **401** `UNAUTHORIZED`: missing or invalid API key
* **403** `NOT_RESELLER`: account is not a reseller