---
title: "List a group's or an organization's users"
method: GET
path: "/groups/{group_id}/users"
tags: ["Groups"]
---

# List a group's or an organization's users

`GET /groups/{group_id}/users`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/groups/{group_id}/users`
- Auth: HTTP bearer

## Path parameters

- `group_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `status` string[]

## Response `200`

A successful response.

- S12ThepubV1ListUsersInGroupResponse: Result returned from `ListUsersInGroup`
  - `total` integer: The number of users in the group.
  - `offset` integer: The offset of the request.
  - `limit` integer: The limit of the request.
  - `users` S12ThepubV1ListUsersInGroupResponseUser[]: The users in the group.
    - `user_id` string: The id of the user.
    - `firstname` string: The first name of the user.
    - `lastname` string: The last name of the user.
    - `email` string: The email address of the user.
    - `status` 'active' | 'inactive': - active: Active user. - inactive: Inactive user.
    - `seat_type` 'full' | 'free' | 'lite'

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
