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

# Get subuser

> GET /api/reseller/v1/subusers/{id}: details for one subuser

Fetch details for a specific subuser.

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

## Path parameters

<ParamField path="id" type="string" required>
  The subuser username (the full prefixed username, e.g. `MYSTORE_user1`).
</ParamField>

## Response

<ResponseField name="id" type="string">Internal subuser ID.</ResponseField>
<ResponseField name="username" type="string">Full prefixed username.</ResponseField>
<ResponseField name="email" type="string">Subuser email.</ResponseField>
<ResponseField name="bandwidthBalance" type="number">Remaining bandwidth (MB).</ResponseField>
<ResponseField name="createdAt" type="string">Creation timestamp (ISO 8601).</ResponseField>
<ResponseField name="whitelistIPs" type="array">Whitelisted IPs.</ResponseField>
<ResponseField name="password" type="string">Current subuser password.</ResponseField>

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": {
    "id": "subuser-125",
    "username": "MYSTORE_user1",
    "email": "user1@example.com",
    "bandwidthBalance": 85,
    "createdAt": "2026-02-22T11:00:00Z",
    "whitelistIPs": ["192.168.1.1"],
    "password": "GeneratedSecurePassword123!"
  }
}
```

## Errors

* **401** `UNAUTHORIZED`: missing or invalid API key
* **403** `NOT_RESELLER`: account is not a reseller
* **404** `NOT_FOUND`: no subuser with that username