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

# List users

`GET /users`

Returns active users visible to the authenticated user.

Rate limits:
- Global: 120 requests per minute per API key.

## Query parameters

- `search` string
- `cursor` string
- `limit` integer

## Response `200`

Users fetched successfully.

- UsersIndexResponse
  - `data` UserListItem[], required
    - `id` string, required — Internal user id.
    - `firstName` string, required — First name of the user.
    - `lastName` string, required — Last name of the user.
    - `email` string, email, required — Primary email of the user.
    - `role` 'user' | 'manager' | 'company_admin', required — Role of the user within the company.
    - `locale` string, required — Locale of the user.
    - `timeZone` string, required — IANA time zone of the user.
  - `meta` object, required
    - `hasNext` boolean, required
    - `limit` integer, required
    - `nextCursor` string, nullable

## Other responses

- `400` — Request validation failed.
- `401` — API key is missing or invalid.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/demodesk/apis/demodesk-public-api.md) · [All operations](https://skmtc.net/demodesk/apis/demodesk-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/demodesk/demodesk-public-api/revisions/3c40ff85e81d/schema)