> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reachedapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workspaces

> Returns all workspaces in your company.

# List Workspaces

Returns all workspaces for your company. A synthetic default workspace with `id=null` is included first, so you can map all UUIDs even if your company does not formally use workspaces.

## Request

`GET /v1/workspaces`

## Example

```bash cURL theme={null}
curl -X GET \
  "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/workspaces" \
  -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"
```

```javascript JavaScript theme={null}
const response = await fetch(
  "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/workspaces",
  {
    headers: {
      "Authorization": "Bearer rchd_live_xxxxxxxxxxxx"
    }
  }
);
const { data, meta } = await response.json();
```

## Response

```json theme={null}
{
  "data": [
    {
      "id": null,
      "name": "Default workspace",
      "created_at": null,
      "updated_at": null
    },
    {
      "id": "w1a2b3c4-...",
      "name": "France Team",
      "created_at": "2026-06-13T08:09:13.000Z",
      "updated_at": "2026-06-13T08:09:13.000Z"
    }
  ],
  "meta": {
    "total": 2
  }
}
```

### Response Fields

| Field | Type | Description |
| - | - | - |
| `id` | uuid \| null | Workspace unique identifier (`null` for the default workspace) |
| `name` | string | Workspace name |
| `created_at` | datetime \| null | Creation timestamp (`null` for the default workspace) |
| `updated_at` | datetime \| null | Last update timestamp (`null` for the default workspace) |

> [!NOTE]
>
> The default workspace (`id: null`) represents leads, campaigns, and call logs that were created before workspaces were introduced or that are not assigned to a specific workspace. Use this endpoint to map `workspace_id` values returned in other API responses to human-readable names.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.