---
title: "Get one workspace"
method: GET
path: "/api/workspaces/{id}"
tags: ["Workspaces"]
---

# Get one workspace

`GET /api/workspaces/{id}`

## Request

- Base URL: `https://api.dunsocial.com`
- URL: `https://api.dunsocial.com/api/workspaces/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `X-Workspace-Id` string, required

## Response `200`

Workspace

- object
  - `success` true, required
  - `data` Workspace
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `logo` string, nullable
    - `timezone` string
    - `role` string
    - `subscription` WorkspaceSubscription
      - `status` string
      - `planName` string, nullable
      - `hasAccess` boolean
      - `accessMessage` string
      - `billingUrl` string
      - `cancelAtPeriodEnd` boolean
      - `currentPeriodEnd` string, nullable

## Other responses

- `401`: Missing or invalid bearer token
- `403`: Wrong workspace, missing scope, or role
- `404`: Resource not found

---

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