---
title: "Get Proxy User List Options"
method: POST
path: "/public/user/proxy/list/options"
tags: ["Proxy"]
---

# Get Proxy User List Options

`POST /public/user/proxy/list/options`

This endpoint returns a list of all active proxy users on the customer's account,
along with a boolean flag indicating whether each proxy user has access to export/use
the specified proxies based on their access type and ACL rules.

**Access Logic:**
- **Unrestricted (all)**: Proxy user has access to all proxies on the account
- **Service Restricted**: Proxy user has access only if they have ACL entries for all services
  containing the specified proxies
- **Proxy Restricted**: Proxy user has access only if they have ACL entries for all
  specified proxies

**Note:** This endpoint is intentionally a POST request (rather than GET) to support
large lists of proxy IDs in the request body.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `proxy_ids` string[] — List of proxy UUIDs to check access against. Either proxy_ids or search_filter must be provided, but not both.
  - `search_filter` object — Search filter object to find proxies (same format as /proxy/list_by_search endpoint). Either proxy_ids or search_filter must be provided, but not both.

## Response `200`

Successfully retrieved proxy user list options.

- object
  - `data` object[] — List of proxy users with access information.
    - `has_access` boolean — Indicates whether this proxy user has permission to access/export all of the specified proxies based on their access type and ACL rules.
    - `proxy_user_id` string — The unique identifier for the proxy user.
    - `proxy_user_is_default` boolean — Indicates if this is the default proxy user for the account.
  - `message` string — Success message.

## Other responses

- `400` — Bad request - invalid parameters or missing required fields.
- `404` — No proxies found matching the specified criteria.

---

[API](https://skmtc.dev/byteful/apis/byteful-public-user-api.md) · [All operations](https://skmtc.dev/byteful/apis/byteful-public-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteful/byteful-public-user-api/revisions/3db1a6fc0099/schema)