---
title: List managed companies
description: >-
  Returns a paginated list of managed companies. Supports filtering by parent
  ID, name, license limit, status, type, and add-ons, and sorting by multiple
  fields.
category: API Reference
lastModified: '2026-05-18'
url: >-
  https://developer.lastpass.com/business/docs/managed-companies/list-managed-companies.md
---

# List managed companies

`GET /v1/managed-companies`

**Operation ID**: `listManagedCompanies`

## Quick Start

```http
GET https://api.lastpass.com/business/v1/managed-companies
Authorization: api-key <your-api-key>
```

Returns a paginated list of managed companies. Supports filtering by parent ID, name, license limit, status, type, and add-ons, and sorting by multiple fields.

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `max-results` | query | integer | No | The number of elements to retrieve. *(format: int32; default: 10; range: 1–500)* |
| `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 according to client criteria. |
| `parent-id` | query | integer | No | Filter companies based on the parent company ID. Returns the specified company and all of its managed companies in the organizational hierarchy. *(format: int64)* |
| `name` | query | string | No | Full-text search on the full name of the company. |
| `license-limit` | query | string | No | Filter by license limit. |
| `status` | query | array (csv) | No | Filter by managed company status. Pass multiple values as a comma-separated list (e.g. `active,suspended`). |
| `type` | query | array (csv) | No | Filter by managed company type. Pass multiple values as a comma-separated list (e.g. `msp,managed-msp`). |
| `addon` | query | array (csv) | No | Filter by add-ons. Pass multiple values as a comma-separated list (e.g. `mfa,sso`). |

**Examples for `sort`:** `id:asc`, `id:desc`, `name:asc`, `name:desc`, `license-limit:asc`, … (7 more)

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

**Examples for `license-limit`:** `[minValue:maxValue]`, `[:maxValue]`, `[minValue:]`

## Responses

### 200

OK

#### Schema

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

#### Example

```json
{
  "items": [
    {
      "id": 0,
      "parentId": 0,
      "name": "string",
      "licenseLimit": 0,
      "type": "managed",
      "addons": [
        "mfa"
      ],
      "status": "active"
    }
  ],
  "nextPageToken": "string"
}
```

### 400

Bad Request

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 401

Unauthorized

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 402

Subscription Expired

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 403

Forbidden

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 404

Not Found

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 429

Too Many Requests

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```

### 500

Internal Server Error

#### Schema

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | string | No | Short, human-readable summary of the problem type. *(nullable)* |
| `status` | integer | No | HTTP status code. *(nullable)* |
| `detail` | string | No | Human-readable explanation specific to this occurrence of the problem. *(nullable)* |
| `instance` | string | No | URI reference identifying the specific occurrence of the problem. *(nullable)* |
| `errors` | array of ProblemDetailsError | No | List of individual field-level validation errors, if applicable. *(nullable)* |

#### Example

```json
{
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "detail": "string",
      "pointer": "string"
    }
  ]
}
```