## List

**get** `/v1/viewer/users`

Retrieves a paginated list of users with optional filtering by access level, email, name, and invitation source. Returns up to 100 users per request.

### Query Parameters

- `cursor: optional string`

  Base64 encoded cursor from previous response

- `email: optional string`

  Filter by exact email match

- `firstName: optional string`

  Filter by first name (contains match)

- `invitedSource: optional "dashboard" or "api"`

  Filter by invitation source

  - `"dashboard"`

  - `"api"`

- `lastName: optional string`

  Filter by last name (contains match)

- `level: optional "owner" or "admin" or "member"`

  Filter by user level

  - `"owner"`

  - `"admin"`

  - `"member"`

- `limit: optional number`

  Number of results to return (1-100)

### Returns

- `hasMore: boolean`

- `users: array of object { canManageStudies, clinicRole, createdAt, 12 more }`

  - `canManageStudies: boolean`

    Whether the user has permission to create, update, and manage studies

  - `clinicRole: "Radiologist" or "Cardiologist" or "Neurologist" or 18 more`

    User's clinical or organizational role

    - `"Radiologist"`

    - `"Cardiologist"`

    - `"Neurologist"`

    - `"Urologist"`

    - `"Gynecologist"`

    - `"Endocrinologist"`

    - `"Doctor"`

    - `"Surgeon"`

    - `"Physician"`

    - `"Physician Assistant"`

    - `"Nurse Practitioner"`

    - `"Registered Nurse"`

    - `"Patient Care Coordinator"`

    - `"Front Desk Operator"`

    - `"Imaging Technologist"`

    - `"PACS Administrator"`

    - `"Software Engineer"`

    - `"Revenue Cycle Manager"`

    - `"Administrative Director"`

    - `"Administrative Assistant"`

    - `"Other"`

  - `createdAt: string`

    Timestamp when the user was created

  - `email: string`

    User's email address for login and notifications

  - `firstName: string`

    User's first name

  - `hasDashboardAccess: boolean`

    Whether the user can access the dashboard interface. Required for admin users

  - `invitedSource: "dashboard" or "api"`

    How the user was invited - via dashboard UI or API

    - `"dashboard"`

    - `"api"`

  - `lastLoginAt: string`

    Timestamp of user's last login, null if never logged in

  - `lastName: string`

    User's last name

  - `level: "owner" or "admin" or "member"`

    User access level. 'owner' has full control, 'admin' can manage users/settings, 'member' has standard access

    - `"owner"`

    - `"admin"`

    - `"member"`

  - `userId: string`

    Unique user identifier. Format: usr_{32-hex-chars}

  - `middleName: optional string`

    User's middle name (optional)

  - `phoneNumber: optional string`

    User's phone number (10-15 digits, optional)

  - `suffix1: optional string`

    Name suffix (e.g., 'Jr.', 'Sr.', 'III') - optional

  - `suffix2: optional string`

    Additional name suffix (optional)

- `cursor: optional string`

### Example

```http
curl https://api.avarasoftware.com/v1/viewer/users \
    -H "Authorization: Bearer $AVARA_API_KEY"
```