Skip to main content
GET
Get bandwidth history
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

Errors

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