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

> Returns the residential and premium residential packages you own that can be used with add data and proxy generation.

Returns the residential and premium residential packages you own. Use the `package_id` from this list with [get a package](/api/packages/get), [add data](/api/packages/add-data), [remove data](/api/packages/remove-data), and [generate proxies](/api/proxies/generate).

This endpoint takes no request body.

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

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

  resp = requests.get(
      "https://flameproxies.com/api/customer/my-packages",
      headers={"Authorization": "Bearer fp_live_xxx"},
  )
  for pkg in resp.json()["packages"]:
      print(pkg["package_id"], pkg["plan"], pkg["is_primary"])
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "packages": [
      {
        "id": 123,
        "package_id": 123,
        "internal_id": "70437286-78a1-427c-b9fd-c299baadf3a9",
        "subuser_id": "56789",
        "plan": "premium_residential",
        "username": "fp-user",
        "created_at": "2026-05-13T12:00:00.000Z",
        "end_date": null,
        "is_primary": true,
        "api_created": true
      }
    ]
  }
  ```
</ResponseExample>

## Response

<ResponseField name="packages" type="object[]">
  The packages you own.

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

    <ResponseField name="package_id" type="number">
      Numeric package ID. Use it in the path of package endpoints and as `package_id` when generating proxies.
    </ResponseField>

    <ResponseField name="internal_id" type="string">
      The package's UUID. [Get a package](/api/packages/get) accepts this in place of `package_id`.
    </ResponseField>

    <ResponseField name="subuser_id" type="string">
      ID of the [sub-user](/dashboard/sub-users) behind this package.
    </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="end_date" type="string | null">
      End date of the package, or `null` if it has none.
    </ResponseField>

    <ResponseField name="is_primary" type="boolean">
      `true` for your main package.
    </ResponseField>

    <ResponseField name="api_created" type="boolean">
      `true` if the package was created through the Customer API.
    </ResponseField>
  </Expandable>
</ResponseField>