---
title: List user groups
description: >-
  Returns a paginated list of user groups. Supports filtering by name. Supports
  sorting.
category: API Reference
lastModified: '2026-10-26'
url: https://developer.lastpass.com/business/docs/user-groups/list-user-groups.md
---

# List user groups

`GET /v1/user-groups`

**Operation ID**: `listUserGroups`

## Quick Start

```http
GET https://api.lastpass.com/business/v1/user-groups
Authorization: Api-Key <your-api-key>
```

Returns a paginated list of user groups. Supports filtering by name. Supports sorting.

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `max-results` | query | integer | No | The number of elements to retrieve. *(format: int32; default: 10; range: 1–50)* |
| `page-token` | query | string | No | Continuation token used to retrieve the next page from the collection of resources. This parameter should be set with the value returned as `nextPageToken`. |
| `sort` | query | string | No | Sort the resource collection. |
| `name` | query | string | No | Full-text search on the name of the group. |

**Examples for `sort`:** `id:asc`, `id:desc`, `name:asc`, `name:desc`

**Examples for `name`:** `name%`, `%name%`, `%name`, `%first%second%`

## Responses

### 200

OK

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `nextPageToken` | string | No | Token to retrieve the next page; null if no further pages exist. *(nullable)* |
| `items` | array of UserGroup | Yes | List of groups in the current page. *(nullable)* |

#### Example

```json
{
  "nextPageToken": "string",
  "items": [
    {
      "id": 0,
      "name": "string",
      "securityScore": "low"
    }
  ]
}
```

### 400

Bad Request

### 401

Unauthorized

### 402

Subscription Expired

### 403

Forbidden

### 404

Not Found

### 429

Too Many Requests

### 500

Internal Server Error