---
title: "GET /api/spaces"
method: GET
path: "/api/spaces"
tags: ["SpaceService"]
---

# GET /api/spaces

`GET /api/spaces`

## Request

- The document declares no server URL.
- Auth: none declared

ListSpaces lists the spaces of which the authenticated caller is a member.

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

OK

- ListSpacesResponse: Response message for SpaceService.ListSpaces.
  - `spaces` Space[]: The spaces of which the caller is a member.
    - `name` string: Identifier. The resource name of the space. Format: spaces/{space}
    - `title` string, required: Required. The human-readable title.
    - `description` string: Optional. A description of the space.
    - `icon` SpaceIcon: Icon is the display icon of a space.
      - `emoji` string: A Unicode emoji sequence.
      - `lucide` string: A canonical Lucide icon name, such as "leaf".
    - `currentUserRole` 'ROLE_UNSPECIFIED' | 'ADMIN' | 'USER', enum: Output only. The authenticated user's membership role in this space. ROLE_UNSPECIFIED when this space is exposed as metadata only.
    - `memberCount` integer: Output only. The number of accepted members in this space. Pending invitations are excluded. Zero when this space is exposed as metadata only.
  - `nextPageToken` string: A token to retrieve the next page. Empty when there are no more pages.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-08** `1846a777b0ef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/spaces/get.md)

---

[API](https://skmtc.dev/usememos/apis/untitled-api.md) - [All operations](https://skmtc.dev/usememos/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usememos/apis/untitled-api/revisions/f587355e35b4?raw)