---
title: "List the Workspaces this credential may select: the person's calculated default and legacy personal Workspace plus explicitly granted Workspaces they are a member of."
method: GET
path: "/api/v2/workspaces"
---

# List the Workspaces this credential may select: the person's calculated default and legacy personal Workspace plus explicitly granted Workspaces they are a member of.

`GET /api/v2/workspaces`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/workspaces`
- Auth: HTTP bearer

## Response `200`

The calculated default first, then any distinct legacy personal Workspace, then granted Workspaces by name, each with the person's role.

- WorkspaceList
  - `data` Workspace[]
    - `id` string: Opaque public Workspace ID (ws_...) — the value accepted by the workspace_id query parameter.
    - `name` string
    - `role` 'owner' | 'admin' | 'editor' | 'viewer' | 'null', nullable: The credential's person's role in this Workspace. It caps what any credential may do there: a write the role does not allow returns 403.
    - `is_default` boolean: True for the oldest owned Workspace, or the oldest Workspace the person belongs to when they own none, ordered by Workspace creation time. Used when workspace_id is omitted.
    - `created_at` string, date-time, nullable
    - `sandbox` boolean: Sandbox Workspace: new bank links use supported test environments. Existing connection environments never change.

---

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