GET /usage
Get current month usage for a workspace the operator token can access.
GET /usage
Returns current-month character, request, and language-detection usage for a workspace the operator token can access.
Request
GET /api/v1/usage?workspace=my-workspace
Authorization: Bearer opt_your-tokenQuery Parameters
| Field | Type | Required | Description |
|---|---|---|---|
workspace | string | No | Workspace slug or id. Required when the token can access multiple workspaces. |
project_slug | string | No | Project slug used to infer the workspace. |
project_id | string | No | Deprecated: use project_slug. Project ID used to infer the workspace. |
Response (200)
{
"monthlyCharacters": 12450,
"monthlyRequests": 342,
"monthlyDetections": 1280,
"workspace": {
"id": "org_abc123",
"slug": "my-workspace",
"name": "My Workspace"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
monthlyCharacters | number | Characters translated this month |
monthlyRequests | number | Translation requests this month |
monthlyDetections | number | Texts language-detected this month (a batch counts each text); not quota-metered |
workspace | object | Resolved workspace (id, slug, name) |
Example
curl "https://your-domain.com/api/v1/usage?workspace=my-workspace" \
-H "Authorization: Bearer opt_your-token"Notes
- Usage resets at the start of each month
- Quotas are workspace-wide; every operator token in a workspace shares the same quota
- Any workspace member can read usage with an operator token
- Check usage programmatically to avoid hitting quota limits