---
title: "list users"
method: GET
path: "/api/v1/users"
tags: ["users"]
---

# list users

`GET /api/v1/users`

## Query parameters

- `page` integer
- `pageSize` integer
- `name` string
- `email` string
- `alias` string

## Response `200`

OK

- V1ListUserResponse
  - `total` integer, required
  - `users` V1DetailUserResponse[], required
    - `alias` string
    - `createTime` string, date-time, required
    - `disabled` boolean, required
    - `email` string, required
    - `lastLoginTime` string, date-time, required
    - `name` string, required
    - `projects` V1UserProjectBase[], required
      - `alias` string, required
      - `description` string, required
      - `joinTime` string, date-time, required
      - `name` string, required
      - `owner` V1NameAlias
        - `alias` string, required
        - `name` string, required
      - `roles` V1NameAlias[], required
        - `alias` string, required
        - `name` string, required
    - `roles` V1NameAlias[], required
      - `alias` string, required
      - `name` string, required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/kubevela/apis/kubevela-api-doc.md) · [All operations](https://skmtc.net/kubevela/apis/kubevela-api-doc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kubevela/kubevela-api-doc/revisions/8e41615b25d5/schema)