Skip to main content
GET
/
api
/
reseller
/
v1
/
subusers
List subusers
curl --request GET \
  --url https://www.eclipseproxy.com/api/reseller/v1/subusers
{
  "id": "<string>",
  "username": "<string>",
  "email": "<string>",
  "bandwidthBalance": 123,
  "createdAt": "<string>",
  "whitelistIPs": [
    {}
  ]
}
Retrieve every subuser under your reseller account.

​
Authentication

Requires a reseller API key. Pass it as Authorization: Bearer YOUR_API_KEY or X-API-Key: YOUR_API_KEY. See Reseller overview.

​
Response

data is an array of subuser objects.
​
id
string
Internal subuser ID.
​
username
string
Full username, prefixed with your store code.
​
email
string
Subuser email.
​
bandwidthBalance
number
Bandwidth allocated to the subuser (MB).
​
createdAt
string
Creation timestamp (ISO 8601).
​
whitelistIPs
array
Whitelisted IPs for the subuser.

​
Example response

{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": [
    {
      "id": "subuser-123",
      "username": "MYSTORE_user1",
      "email": "[email protected]",
      "bandwidthBalance": 100,
      "createdAt": "2026-02-20T14:22:00Z",
      "whitelistIPs": ["192.168.1.1", "10.0.0.1"]
    }
  ]
}

​
Errors

  • 401 UNAUTHORIZED: missing or invalid API key
  • 403 NOT_RESELLER: account is not a reseller