> ## Documentation Index
> Fetch the complete documentation index at: https://developers.flameproxies.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List non-API package usage

> Returns your regular residential and premium residential packages with live usage attached.

Returns your regular residential and premium residential packages with live usage attached. Packages created through the Customer API are excluded.

Use it to monitor bandwidth across all your regular packages in one call — for example, to alert when a package drops below a threshold.

This endpoint takes no request body.

<RequestExample>
  ```bash cURL theme={null}
  curl https://flameproxies.com/api/customer/non-api-packages/usage \
    -H "Authorization: Bearer fp_live_xxx"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://flameproxies.com/api/customer/non-api-packages/usage",
      headers={"Authorization": "Bearer fp_live_xxx"},
  )
  for pkg in resp.json()["packages"]:
      if pkg["usage"]["percent_used"] > 90:
          print(f"Package {pkg['id']} is almost out of bandwidth")
  ```

  ```javascript Node.js theme={null}
  const resp = await fetch("https://flameproxies.com/api/customer/non-api-packages/usage", {
    headers: { Authorization: "Bearer fp_live_xxx" },
  });
  const { packages } = await resp.json();
  for (const pkg of packages) {
    if (pkg.usage.percent_used > 90) console.log(`Package ${pkg.id} is almost out of bandwidth`);
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "packages": [
      {
        "id": 321,
        "plan": "residential",
        "username": "fp-user",
        "created_at": "2026-05-13T12:00:00.000Z",
        "usage": {
          "bytes_used": 1200000000,
          "max_bytes": 5000000000,
          "remaining_bytes": 3800000000,
          "gb_used": 1.2,
          "gb_total": 5,
          "gb_remaining": 3.8,
          "percent_used": 24
        }
      }
    ]
  }
  ```
</ResponseExample>

## Response

<ResponseField name="packages" type="object[]">
  Your regular packages, with usage.

  <Expandable title="package">
    <ResponseField name="id" type="number">
      Numeric package ID.
    </ResponseField>

    <ResponseField name="plan" type="string">
      Product: `residential` or `premium_residential`.
    </ResponseField>

    <ResponseField name="username" type="string">
      Proxy username for this package.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      When the package was created, as an ISO 8601 timestamp.
    </ResponseField>

    <ResponseField name="usage" type="object">
      Live bandwidth usage.

      <Expandable title="usage">
        <ResponseField name="bytes_used" type="number">
          Bytes used so far.
        </ResponseField>

        <ResponseField name="max_bytes" type="number">
          Total bytes available on the package.
        </ResponseField>

        <ResponseField name="remaining_bytes" type="number">
          Bytes left.
        </ResponseField>

        <ResponseField name="gb_used" type="number">
          GB used so far.
        </ResponseField>

        <ResponseField name="gb_total" type="number">
          Total GB available on the package.
        </ResponseField>

        <ResponseField name="gb_remaining" type="number">
          GB left.
        </ResponseField>

        <ResponseField name="percent_used" type="number">
          Percentage of the package's bandwidth used.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>