---
title: "List your workspaces"
description: "Every workspace the person can open, the ones they own first, as the workspace switcher of the app lists them."
url: "https://openemail.uk/docs/api/workspaces/list"
area: "API"
category: "Your account"
---

# List your workspaces

Every workspace the person can open, the ones they own first, as the workspace switcher of the app lists them.

`GET /workspaces`

## GET /workspaces

Every workspace the person can open, the ones they own first, as the workspace switcher of the app lists them.

## Example

Needs `account:read`. `activeWorkspaceId` is the workspace the app opens for the person, `primaryWorkspaceId` the first one they made, which can never be deleted, and `personalWorkspaceId` their personal space, which holds their free address and is not listed in `data`.

**curl**

```
curl "$OE/workspaces" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [
    {
      "object": "workspace",
      "id": "10417196-e324-4283-af98-66ec62167c47",
      "name": "Acme",
      "slug": "acme",
      "email": "hello@acme.com",
      "isOwner": true,
      "ownerId": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",
      "plan": "business",
      "markUrl": null,
      "wordmarkUrl": null,
      "createdAt": "2026-08-01T10:00:00.000Z"
    }
  ],
  "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",
  "primaryWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",
  "personalWorkspaceId": "5b1e7c40-2d9a-4f63-b8e1-0c4d7a2f9e15"
}
```

> These calls act on a person, not on a workspace. An API key acts for the owner of the workspace it belongs to, and an app for the person who connected it. Reading needs `account:read` and every change `account:write`, and no role limits either.

> The key or the app itself still acts for exactly one workspace in every other call. Nothing here widens it.

## Reference

- [`GET /workspaces`](https://openemail.uk/docs/api/reference/workspaces#get-workspaces): full reference