---
title: "Get Self-Serve Workspace Allowance"
method: GET
path: "/tenants/self-serve/allowance"
tags: ["tenants"]
---

# Get Self-Serve Workspace Allowance

`GET /tenants/self-serve/allowance`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/tenants/self-serve/allowance`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Returns the caller's workspace plan (projected from enforcer-billing), the effective number of workspaces they may own (`workspace_slots` — the instance default when billing has not projected a plan for them), how many live workspaces they own (`owned`), and whether the limit is enforced on this instance (`enforced`). Read-only. Only workspaces created through `selfServeTenant` count as owned.

## Response `200`

OK

- InternalDeliveryHttpHandlerWorkspaceAllowanceResponse
  - `data` InternalDeliveryHttpHandlerWorkspaceAllowanceView
    - `enforced` boolean: Enforced is true when self-serve creation is capped at WorkspaceSlots on this instance; false means the numbers are informational.
    - `has_plan` boolean
    - `mau_per_workspace` integer
    - `owned` integer: Owned is how many live workspaces the caller owns.
    - `plan_id` string: PlanID is the workspace plan: personal | developer | business, or "" when the caller has no plan.
    - `workspace_slots` integer: WorkspaceSlots is the effective number of workspaces the caller may own.
  - `success` boolean

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error

---

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