> ## 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

<CodeGroup>
  ```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();
  ```
</CodeGroup>

## 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.
</Note>