---
title: "List users"
method: GET
path: "/api/v1/users"
tags: ["Users"]
---

# List users

`GET /api/v1/users`

Returns every user in your Cortex tenant along with their profile metadata: name, email, join date, and last active timestamp. Intended for access reviews, compliance, and auditing. Role assignments are available from the separate GET /api/v1/users/roles endpoint. Requires the View Roles permission; assign it to a custom role to issue a least-privilege API key for automated reporting.

## Query parameters

- `email` string[]
- `pageSize` integer, required
- `page` integer, required

## Response `200`

Successfully retrieved users

- UsersResponse
  - `page` integer, required — Current page number, 0-indexed
  - `total` integer, required — Total number of results
  - `totalPages` integer, required — Total number of pages
  - `users` User1[], required — Users for the current page
    - `email` string, required — Email address of the user
    - `joinedAt` string, date-time, required — When the user was first added to Cortex (join date), as a UTC ISO-8601 instant
    - `lastActiveAt` string, date-time — Last time the user logged in, as a UTC ISO-8601 instant; null if the user has never logged in
    - `name` string, required — Display name of the user

## Other responses

- `401` — Authentication required
- `403` — Caller does not have the View Roles permission
- `429` — The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

---

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