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

# List Users V2

`GET /v2/users`

List users for an organisation.

## Query parameters

- `email` string
- `slack_user_id` string
- `page_size` integer
- `after` string

## Response `200`

OK response.

- UsersV2ListResponseBody
  - `pagination_meta` PaginationMetaResult, required
    - `after` string — If provided, pass this as the 'after' param to load the next page
    - `page_size` integer, required — What was the maximum number of results requested
  - `users` UserWithRolesV2[], required
    - `base_role` RBACRoleV2, required
      - `description` string — Description of the purpose for the RBAC role
      - `id` string, required — Unique identifier of the RBAC role
      - `name` string, required — Name of the RBAC role
      - `slug` string, required — Unique human-readable slug for the RBAC role
    - `custom_roles` RBACRoleV2[], required
      - `description` string — Description of the purpose for the RBAC role
      - `id` string, required — Unique identifier of the RBAC role
      - `name` string, required — Name of the RBAC role
      - `slug` string, required — Unique human-readable slug for the RBAC role
    - `email` string — Email address of the user.
    - `id` string, required — Unique identifier of the user
    - `name` string, required — Name of the user
    - `role` 'viewer' | 'responder' | 'administrator' | 'owner' | 'unset', required — DEPRECATED: Role of the user as of March 9th 2023, this value is no longer updated.
    - `slack_user_id` string — Slack ID of the user

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)