Get bandwidth history

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

GEThttps://www.eclipseproxy.com/api/reseller/v1/subusers/{id}/bandwidth/historyBearer auth

Retrieve the bandwidth allocation and deallocation history for a subuser.

Example request

curl -X GET "https://www.eclipseproxy.com/api/reseller/v1/subusers/SUBUSER_ID/bandwidth/history" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

idpathstringrequired

The subuser username (full prefixed username, e.g. MYSTORE_user1).

Response

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

actionstring

ADD (bandwidth allocated to the subuser) or REMOVE (bandwidth deallocated).

amountMbnumber

Amount of bandwidth moved, in MB.

atstring

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