---
title: "List workspaces in a company"
method: GET
path: "/companies/{id}/workspaces"
tags: ["Company"]
---

# List workspaces in a company

`GET /companies/{id}/workspaces`

Returns every workspace belonging to the company, grouped by the owning account. Endpoint authorized with a company-scoped API key, or by a company admin user.

## Path parameters

- `id` string, required

## Response `200`

The accounts in the company, each with its workspaces

- CompanyWorkspacesResult — All workspaces in a company, grouped by their owning account
  - `company_id` string — The id of the company the workspaces belong to
  - `accounts` CompanyAccountWorkspaces[] — The company's accounts, each with the workspaces it owns
    - `account_id` string — The id of the account
    - `account_name` string — The display name of the account
    - `workspaces` CompanyWorkspaceSummary[] — The workspaces owned by this account
      - `id` string — The id of the workspace
      - `name` string — The display name of the workspace

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Company not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)