---
title: "All workspaces with usage"
method: GET
path: "/api/v1/admin/workspaces"
tags: ["Admin"]
---

# All workspaces with usage

`GET /api/v1/admin/workspaces`

## Request

- Base URL: `https://otprun.com`
- URL: `https://otprun.com/api/v1/admin/workspaces`
- Auth: HTTP bearer

## Query parameters

- `search` string
- `unlimited` boolean: Only workspaces with unlimited use granted by the platform
- `cursor` string
- `limit` integer

## Response `200`

OK

- WorkspacesOutputBody
  - `items` AdminWorkspaceBody[], nullable, required
    - `created_at` string, date-time, required
    - `id` integer, required
    - `members` integer, required
    - `messages_30d` integer, required
    - `name` string, required
    - `owner_email` string, required
    - `plan` 'free' | 'starter' | 'growth' | 'scale', required
    - `projects` integer, required
    - `slots` integer, required
    - `slug` string, required
    - `trial_ends_at` string, date-time, nullable, required
    - `unlimited_at` string, date-time, nullable, required: When the platform granted unlimited use, null when the plan limits apply
  - `next_cursor` string

## Other responses

- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/otprun/apis/otp-run-api.md) · [All operations](https://skmtc.dev/otprun/apis/otp-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/otprun/apis/otp-run-api/revisions/43d40d5f4050?raw)