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

# List Users

`GET /api/platform/users`

Paginated, searchable listing of users in the connected Auth0 tenant.

Identity-only. Use ``GET /platform/users/{user_id}/memberships`` to
fetch FGA-derived organization and group memberships for a single
user.

## Query parameters

- `page` integer
- `per_page` integer
- `q` string — Search by name or email (Auth0 Lucene query)

## Response `200`

Successful Response

- UsersListResponse — Paginated list envelope for :class:`User`.
  - `items` User[]
    - `userId` string, required
    - `email` string, nullable
    - `name` string, nullable
    - `picture` string, nullable
    - `loginCount` integer
    - `lastLogin` string, nullable
    - `createdAt` string, nullable
    - `linkedSubs` string[]
  - `total` integer
  - `page` integer
  - `perPage` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)