---
title: "List workspaces"
method: GET
path: "/workspaces/"
tags: ["Workspaces"]
---

# List workspaces

`GET /workspaces/`

## Request

- Base URL: `https://hovercode.com/api/v2`
- URL: `https://hovercode.com/api/v2/workspaces/`
- Auth: API key in header `Authorization`

The workspaces your token can use, oldest first, with each one's plan and dynamic-code quota. Use it to find your workspace ID from the token alone; `current` marks the account's most recently used workspace. Paginated 50 per page (max 200).

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

OK

- object
  - `current_workspace` string, uuid, nullable
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Workspace[]
    - `id` string, uuid
    - `name` string
    - `current` boolean
    - `plan` string
    - `paid` boolean
    - `dynamic_qr_used` integer, nullable
    - `dynamic_qr_limit` integer, nullable
    - `pages_used` integer, nullable

## Other responses

- `401`: Missing or invalid API token.

---

[API](https://skmtc.dev/hovercode/apis/hovercode-api.md) · [All operations](https://skmtc.dev/hovercode/apis/hovercode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hovercode/apis/hovercode-api/revisions/4a9bc3cafe41?raw)