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

# List Users

`GET /api/v1/user`

Get a list of users.

## Response `200`

List of users.

- object
  - `links` object — Indicates Links to associated pages.
    - `next` string — The link to the next page (null if there are no more pages).
    - `previous` string — The link to the previous page (null if on the first page).
  - `meta` object — Reprents the meta data of the response.
    - `page` integer — The current page number.
    - `previous_page` integer — The previous page number (null if on the first page).
    - `next_page` integer — The next page number (null if on the last page).
  - `count` integer — The total count of items returned.
  - `total_pages` integer — The total number of pages.
  - `results` V1UsersResponse[]
    - `id` string — Indicates the UUID of the user.
    - `first_name` string — Indicates the first name of the user.
    - `last_name` string — Indicates the last name of the user.
    - `email` string — Indicates the email id of the user.
    - `role` string — Indicates the role of the user. Values can be - <ul><li> Admin <li> Editor <li> Viewer </ul>
    - `workspace_id` string — Indicates the workspace ID of the user.
    - `profile_picture` string — Indicates the file name of the profile picture for the user.
    - `pending` boolean — Represents if the user has been invited to the space but not accepted yet. Values can be - <ul> <li> "True" <li> "False" </ul>
    - `user_groups` string[] — A list of UUIDs of groups the user belongs to.
    - `bookmarks` string[] — Represents the resorces that the user has bookmarked.
    - `workspace` string — Indicates the workspace of the user.
    - `is_service_account` boolean — Indicates if the user account is a service account or not. Values can be - <ul> <li >True <li> False </ul>
    - `service_account_count_popularity` boolean — Indicates if the account counts towards popularity calculations. Values can be - <ul> <li> True <li> False </ul>
    - `last_login` string, date-time — Indicates the last time account was logged in to Secoda in UTC format.
    - `new_feature_acknowledged` boolean — Indicates if the new feature has been acknowleged or not. Values can be - <ul> <li >True <li> False </ul>
    - `disabled` boolean — Represents if the account is disabled or not. Values can be - <ul> <li >True <li> False </ul>

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

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