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

# List Users

`GET /v1/users`

Retrieves information about all users on the authenticated account.

## Response `200`

OK. Returns a list of User resources containing information about users on the account.

- User[]
  - `accountId` number — The unique ID for the user's account.
  - `enabled` boolean — Whether the user can authenticate to Lucid. Corresponds to the SCIM active attribute.
  - `email` string — The user's email.
  - `name` string — The user's full name.
  - `userId` number — The unique ID for the user.
  - `username` string — The user's username.
  - `roles` UserRole[] — A list of administrative roles assigned to the user.
  - `avatar` Avatar — A reference to a user's avatar image. When the user has no uploaded avatar, this falls back to their Gravatar image.
    - `type` 'url', required — The kind of avatar. Currently always `url`, indicating the avatar is referenced by a link. Additional avatar kinds may be introduced in the future.
    - `link` string, required — A URL pointing to the user's avatar image.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)