---
title: "Get token quota status for a workspace"
method: GET
path: "/integrator/usage/token-quota"
tags: ["usage"]
---

# Get token quota status for a workspace

`GET /integrator/usage/token-quota`

Returns the current month's token usage vs. limit for a workspace.

Use this to check remaining quota before LLM operations or to display
a usage bar in the frontend. When `is_limited` is false, the workspace
has no token limit (unlimited).

## Query parameters

- `workspace_id` string, uuid, required — Workspace ID to check

## Response `200`

Successful Response

- TokenQuotaStatus — Result of a token quota check.
  - `is_allowed` boolean, required
  - `tokens_used` integer, required
  - `tokens_limit` integer, required — Effective limit (base + bonus)
  - `tokens_remaining` integer, required
  - `bonus_tokens` integer
  - `period` string, required — Period key YYYYMM
  - `is_limited` boolean, required — False when workspace has no token limit (unlimited)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)