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

# List users

`GET /users`

Lists all the users in the project. Anonymous users are only included if the `include_anonymous` query parameter is set to `true`.

## Query parameters

- `team_id` string — Only return users who are members of the given team
- `limit` number — The maximum number of items to return
- `cursor` string — The cursor to start the result set from.
- `order_by` string — The field to sort the results by. Defaults to signed_up_at
- `desc` string — Whether to sort the results in descending order. Defaults to false
- `query` string — A search query to filter the results by. This is a free-text search that is applied to the user's id (exact-match only), display name and primary email.
- `include_anonymous` string — Whether to include anonymous users in the results. Defaults to false

## Response `200`

Successful response

- object
  - `items` object[], required
    - `id` string, required — The unique identifier of the user
    - `primary_email` string — Primary email
    - `primary_email_verified` boolean, required — Whether the primary email has been verified to belong to this user
    - `primary_email_auth_enabled` boolean, required — Whether the primary email is used for authentication. If this is set to `false`, the user will not be able to sign in with the primary email with password or OTP
    - `display_name` string — Human-readable user display name. This is not a unique identifier.
    - `selected_team` object
      - `created_at_millis` number, required — The time the team was created (the number of milliseconds since epoch, January 1, 1970, UTC)
      - `server_metadata` object — Server metadata. Used as a data store, only accessible from the server side. You can store secret information related to the team here.
      - `id` string, required — The unique identifier of the team
      - `display_name` string, required — Human-readable team display name. This is not a unique identifier.
      - `profile_image_url` string — URL of the profile image for team. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.
      - `client_metadata` object — Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.
      - `client_read_only_metadata` object — Client read-only, server-writable metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client. The client can read this data, but cannot modify it. This is useful for things like subscription status.
    - `selected_team_id` string — ID of the team currently selected by the user
    - `profile_image_url` string — URL of the profile image for user. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.
    - `signed_up_at_millis` number, required — The time the user signed up (identify) => `(the number of milliseconds since epoch, January 1, 1970, UTC)`
    - `client_metadata` object — Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.
    - `client_read_only_metadata` object — Client read-only, server-writable metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client. The client can read this data, but cannot modify it. This is useful for things like subscription status.
    - `server_metadata` object — Server metadata. Used as a data store, only accessible from the server side. You can store secret information related to the user here.
    - `last_active_at_millis` number, required — The time the user was last active (identify) => `(the number of milliseconds since epoch, January 1, 1970, UTC)`
    - `is_anonymous` boolean, required
  - `pagination` object
    - `next_cursor` string — The cursor to fetch the next page of results. null if there is no next page.

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api-3/revisions/8451fc4b3a2e/schema)