---
title: "List all SAML users"
method: GET
path: "/api/v4/groups/{id}/saml_users"
tags: ["groups"]
---

# List all SAML users

`GET /api/v4/groups/{id}/saml_users`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/groups/{id}/saml_users`
- Auth: none declared

Lists all SAML users for a specified top-level group. Use the `page` and `per_page` pagination parameters to filter the results.

## Path parameters

- `id` integer, required

## Query parameters

- `username` string
- `search` string
- `active` boolean
- `blocked` boolean
- `created_after` string, date-time
- `created_before` string, date-time
- `page` integer
- `per_page` integer

## Response `200`

List all SAML users

- APIEntitiesUserPublic[]
  - `id` integer, required
  - `username` string, required
  - `public_email` string, required
  - `name` string, required
  - `state` string, required
  - `locked` boolean, required
  - `avatar_url` string, required
  - `avatar_path` string
  - `custom_attributes` APIEntitiesCustomAttribute[]
    - `key` string, required
    - `value` string, required
  - `web_url` string, required
  - `created_at` string
  - `bio` string, required
  - `location` string, required
  - `linkedin` string, required
  - `twitter` string, required
  - `discord` string, required
  - `website_url` string, required
  - `github` string, required
  - `job_title` string, required
  - `pronouns` string, required
  - `organization` string, required
  - `bot` boolean, required
  - `work_information` string, required
  - `followers` string
  - `following` string
  - `is_followed` string
  - `local_time` string, required
  - `last_sign_in_at` string, date-time, required
  - `confirmed_at` string, date-time, required
  - `last_activity_on` string, date-time, required
  - `email` string, required
  - `theme_id` integer, required
  - `color_scheme_id` integer, required
  - `projects_limit` integer, required
  - `current_sign_in_at` string, date-time, required
  - `identities` APIEntitiesIdentity, required
    - `provider` string, required
    - `extern_uid` string, required
    - `saml_provider_id` string, required
  - `can_create_group` boolean, required
  - `can_create_project` boolean, required
  - `two_factor_enabled` boolean, required
  - `external` boolean, required
  - `private_profile` boolean, required
  - `commit_email` string, required
  - `preferred_language` string, required
  - `shared_runners_minutes_limit` string, required
  - `extra_shared_runners_minutes_limit` string, required
  - `scim_identities` APIEntitiesScimIdentity, required
    - `extern_uid` string, required
    - `group_id` string, required
    - `active` string, required

---

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