---
title: "Get a simplified list of groups"
method: GET
path: "/authorization/groups/list"
tags: ["Authorization"]
---

# Get a simplified list of groups

`GET /authorization/groups/list`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/authorization/groups/list`
- Auth: none declared

Returns a simplified list of groups.

## Query parameters

- `multiContains` IapAuthorizationCommonGroupsQuery
  - `name` string
  - `provenance` string
  - `description` string
- `multiEquals` IapAuthorizationCommonGroupsQuery
  - `name` string
  - `provenance` string
  - `description` string
- `multiStartsWith` IapAuthorizationCommonGroupsQuery
  - `name` string
  - `provenance` string
  - `description` string
- `inactive` boolean: Setting for whether group is active or not
- `skip` integer: Number of results to skip. Used for pagination.
- `limit` integer: Number of results to return. Used for pagination.
- `sort` 'name': Field to sort by. Default is name.
- `order` '-1' | '1': The sort direction: 1 for ascending or -1 for descending.
- `refresh` boolean

## Response `200`

The groups matching the specified query.

- AuthorizationGetGroupsShortListResponse200
  - `results` AuthorizationGroupsListGetResponsesContentApplicationJsonSchemaResults
    - `_id` string: String representation of a MongoDB ObjectId
    - `provenance` string: AAA provider where group originated
    - `name` string: Name of group
  - `total` integer: The total number of documents

## Other responses

- `500`: Error response from API

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)