---
title: "List all internal users"
method: GET
path: "/users"
tags: ["Users"]
---

# List all internal users

`GET /users`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/users`
- Auth: HTTP bearer

Get paginated list of internal users (Admins and Cohort Managers) with filtering and search

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `status` 'all' | 'active' | 'inactive'
- `persona` 'internal_admin' | 'internal_user'
- `sortBy` 'first_name' | 'last_name' | 'email' | 'department' | 'job_title' | 'created_at' | 'last_login_at'
- `sortOrder` 'asc' | 'desc'

## Response `200`

Users retrieved successfully

- object
  - `success` boolean
  - `data` InternalUser[]
    - `id` string, uuid
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `job_title` string
    - `department` string
    - `phone` string
    - `avatar_url` string
    - `is_active` boolean
    - `last_login_at` string, date-time
    - `created_at` string, date-time
    - `persona` 'internal_admin' | 'internal_user'
    - `persona_display` 'Admin' | 'Cohort Manager'
  - `meta` object
    - `pagination` object
      - `page` integer
      - `limit` integer
      - `total` integer
      - `totalPages` integer
    - `totalActive` integer
    - `totalInactive` integer

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)