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

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

Retrieve the bandwidth allocation and deallocation history for a 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

`data.history` is an array of allocation events, each with:

<ResponseField name="action" type="string">
  `ADD` (bandwidth allocated to the subuser) or `REMOVE` (bandwidth deallocated).
</ResponseField>

<ResponseField name="amountMb" type="number">Amount of bandwidth moved, in MB.</ResponseField>
<ResponseField name="at" type="string">Timestamp of the event (ISO 8601).</ResponseField>

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": {
    "username": "MYSTORE_user1",
    "history": [
      {
        "action": "ADD",
        "amountMb": 100,
        "at": "2026-02-22T11:00:00Z"
      },
      {
        "action": "REMOVE",
        "amountMb": 20,
        "at": "2026-02-23T14:30:00Z"
      }
    ]
  }
}
```

## Errors

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