> ## 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 info

> GET /api/reseller/v1/bandwidth: pool balance and account overview

Retrieve your bandwidth pool balance and account overview.

## 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).

## Response

<ResponseField name="bandwidthBalance" type="number">Available bandwidth in MB.</ResponseField>
<ResponseField name="storeName" type="string">Human-readable store name.</ResponseField>
<ResponseField name="storeCode" type="string">Unique store identifier.</ResponseField>
<ResponseField name="subuserCount" type="number">Total subusers created.</ResponseField>
<ResponseField name="totalAllocated" type="number">Total bandwidth allocated across all subusers (MB).</ResponseField>
<ResponseField name="createdAt" type="string">Account creation timestamp (ISO 8601).</ResponseField>

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "OK",
  "messageCode": "OK",
  "data": {
    "bandwidthBalance": 1000,
    "storeName": "My Store",
    "storeCode": "MYSTORE",
    "subuserCount": 5,
    "totalAllocated": 500,
    "createdAt": "2026-01-15T10:30:00Z"
  }
}
```

## Errors

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