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

> GET /api/reseller/v1/subusers/{id}/bandwidth: allocation and usage for a subuser

Retrieve bandwidth allocation and usage 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 (full prefixed username, e.g. `MYSTORE_user1`).
</ParamField>

## Response

<ResponseField name="username" type="string">Full prefixed username.</ResponseField>
<ResponseField name="bandwidthAllocated" type="number">Total bandwidth allocated to the subuser (MB).</ResponseField>
<ResponseField name="bandwidthUsed" type="number">Bandwidth consumed so far (MB).</ResponseField>
<ResponseField name="bandwidthRemaining" type="number">Bandwidth still available (MB).</ResponseField>

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": {
    "username": "MYSTORE_user1",
    "bandwidthAllocated": 100,
    "bandwidthUsed": 15,
    "bandwidthRemaining": 85
  }
}
```

## Errors

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