---
title: "List authorized users"
method: GET
path: "/authorized_users"
tags: ["Authorized users"]
---

# List authorized users

`GET /authorized_users`

Returns a paginated list of authorized team members for a company, with optional filtering by user, role, and creation date.

Required permissions:
 - `company:authorized_user:read`
 - `member:email:read`

## Query parameters

- `after` string — Returns the elements in the list that come after the specified cursor.
- `before` string — Returns the elements in the list that come before the specified cursor.
- `first` integer — Returns the first _n_ elements from the list.
- `last` integer — Returns the last _n_ elements from the list.
- `company_id` string — The unique identifier of the company to list authorized users for.
- `user_id` string — Filter results to a specific user to check if they are an authorized team member.
- `role` 'owner' | 'admin' | 'sales_manager' | 'moderator' | 'advertiser' | 'app_manager' | 'support' | 'manager' | 'workforce' | 'custom' — Possible roles an authorized user can have
- `created_before` string, date-time — Only return authorized users created before this timestamp.
- `created_after` string, date-time — Only return authorized users created after this timestamp.

## Response `200`

A successful response

- object — The connection type for AuthorizedUser.
  - `data` AuthorizedUserListItem[], required — A list of nodes.
    - `company` object, required — The company this authorized user has access to.
      - `id` string, required — The unique identifier for the company.
      - `title` string, required — The display name of the company shown to customers.
    - `id` string, required — The unique identifier for the authorized user.
    - `role` 'owner' | 'admin' | 'sales_manager' | 'moderator' | 'advertiser' | 'app_manager' | 'support' | 'manager' | 'workforce' | 'custom', required — Possible roles an authorized user can have
    - `user` object, required — The user account linked to this authorized user record.
      - `email` string, nullable, required — The user's email address. Requires the member:email:read permission to access. Null if not authorized.
      - `id` string, required — The unique identifier for the user.
      - `name` string, nullable, required — The user's display name shown on their public profile.
      - `username` string, required — The user's unique username shown on their public profile.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

## Changes

- **2026-08-18** `f67a043e3190` — 1 breaking, 11 info
  - the `query` request parameter `role` was restricted to a list of enum values
  - added the new enum value `admin` to the `query` request parameter `role`
  - added the new enum value `advertiser` to the `query` request parameter `role`
  - added the new enum value `app_manager` to the `query` request parameter `role`
  - …8 more
- **2026-08-12** `ae20b30817de` — 1 warning, 1 info
  - added the new `workforce` enum value to the `data/items/role` response property for the response status `200`
  - added the enum value `workforce` to the property `oneOf[#/components/schemas/AuthorizedUserRoles]/` of the `query` request parameter `role`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/authorized_users/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/9e320991dd2f/schema)