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

# Get non-API package usage

> Returns one regular residential or premium residential package with live usage.

Returns one of your regular residential or premium residential packages, with live usage. Packages created through the Customer API are excluded — use [get a package](/api/packages/get) for those.

<ParamField path="id" type="number" required>
  The package's numeric `package_id`, from [list non-API packages](/api/non-api-packages/list).
</ParamField>

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

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

  package_id = 321
  resp = requests.get(
      f"https://flameproxies.com/api/customer/non-api-packages/{package_id}/usage",
      headers={"Authorization": "Bearer fp_live_xxx"},
  )
  print(resp.json()["package"]["usage"])
  ```

  ```javascript Node.js theme={null}
  const packageId = 321;
  const resp = await fetch(
    `https://flameproxies.com/api/customer/non-api-packages/${packageId}/usage`,
    { headers: { Authorization: "Bearer fp_live_xxx" } }
  );
  const { package: pkg } = await resp.json();
  console.log(pkg.usage);
  ```
</RequestExample>

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

## Response

<ResponseField name="package" type="object">
  The package, with usage.

  <Expandable title="properties">
    <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="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>

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