---
title: "List Collections"
method: GET
path: "/{workspace}/spaces"
---

# List Collections

`GET /{workspace}/spaces`

## Request

- Base URL: `https://modeanalytics.com/api`
- URL: `https://modeanalytics.com/api/{workspace}/spaces`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/thoughtspot/apis/mode/docs/:workspace/spaces/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a representation of `Collection`s in a `Workspace` visible to the authenticated `User`

## Path parameters

- `workspace` string, required
- `page` integer, required
- `per_page` integer, required

## Query parameters

- `filter` string

## Response `200`

`Space` collection response

- Spaces
  - `pagination` Pagination
    - `first_page` string, required
    - `last_page` string, required
    - `total_pages` integer, required
    - `total_count` integer, required
  - `_links` SpacesLinks, required
    - `next_page` Link
      - `href` string, required
      - `templated` boolean
    - `prev_page` Link
      - `href` string, required
      - `templated` boolean
    - `self` Link, required
      - `href` string, required
      - `templated` boolean
  - `_embedded` unknown

## Other responses

- `401`: Unauthorized
- `404`: `Workspace` not found

## Changes

- **2024-01-08** `f88772e5a767`: 2 breaking
  - added the new path request parameter `page`
  - added the new path request parameter `per_page`

[Operation history](https://skmtc.dev/thoughtspot/apis/mode/changes/:workspace/spaces/get.md)

---

[API](https://skmtc.dev/thoughtspot/apis/mode.md) - [All operations](https://skmtc.dev/thoughtspot/apis/mode/llms.txt) - [OpenAPI document](https://skmtc.dev/thoughtspot/apis/mode/revisions/4c694c3fdeb1?raw)