---
title: "Get Users"
method: GET
path: "/users"
tags: ["/users"]
---

# Get Users

`GET /users`

Retrieve a list of `users`.

## Query parameters

- `search` string — Query to filter users by email
- `cursor` string — Cursor for the beginning of the current page
- `limit` integer — Number of users to return
- `deactivated` boolean — When set to true, return deactivated users instead.

## Response `200`

Successful Response

- UsersListResponse
  - `users` TenantUserInfo[], required — List of users
    - `email` string, required — The email of the user
    - `is_tenant_admin` boolean — Flag indicating if the user is a tenant admin
    - `roles` UserRolesEnum[] — The user level roles of the user.
    - `id` string, required
    - `effective_roles` UserRolesEnum[] — The effective roles of the user.
  - `next_cursor` string, nullable — Cursor for the beginning of the next page

## Other responses

- `422` — Validation Error

## Changes

- **2025-05-08** `17bdb8a33fb4` — 8 warning, 1 info
  - removed the optional property `users/items/per_agent_roles` from the response with the `200` status
  - added the new `CONTEXTUAL_EXTERNAL_STAFF_USER` enum value to the `users/items/roles/items/` response property for the response status `200`
  - added the new `CONTEXTUAL_INTERNAL_STAFF_USER` enum value to the `users/items/roles/items/` response property for the response status `200`
  - added the new `CONTEXTUAL_STAFF_USER` enum value to the `users/items/roles/items/` response property for the response status `200`
  - …5 more
- **2025-02-08** `d79ccb778953` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/users/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/17bdb8a33fb4/schema)