Skip to main content
GET
/
api
/
reseller
/
v1
/
subusers
/
{id}
/
bandwidth
/
history
Get bandwidth history
curl --request GET \
  --url https://www.eclipseproxy.com/api/reseller/v1/subusers/{id}/bandwidth/history
{
  "action": "<string>",
  "amountMb": 123,
  "at": "<string>"
}
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.

​
Path parameters

​
id
string
required
The subuser username (full prefixed username, e.g. MYSTORE_user1).

​
Response

data.history is an array of allocation events, each with:
​
action
string
ADD (bandwidth allocated to the subuser) or REMOVE (bandwidth deallocated).
​
amountMb
number
Amount of bandwidth moved, in MB.
​
at
string
Timestamp of the event (ISO 8601).

​
Example response

{
  "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