---
title: "GET /v1/workspaces/{workspaceId}/triage-usage"
method: GET
path: "/v1/workspaces/{workspaceId}/triage-usage"
---

# GET /v1/workspaces/{workspaceId}/triage-usage

`GET /v1/workspaces/{workspaceId}/triage-usage`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/triage-usage`
- Auth: HTTP bearer

How much Triage the workspace has used this UTC calendar month against its plan amounts, when the count resets, and the cheapest plan that checks more emails. Past the monthly amount new mail stays unsorted until it resets.

## Response `200`

Successful response.

- object
  - `data` TriageUsage, required
    - `unlimited` boolean, required: Both amounts are lifted for this workspace.
    - `rule_limit` integer, required: Enabled Triage and auto-set rules allowed at once.
    - `rules_enabled` integer, required
    - `run_limit` integer, required: Emails Triage checks per UTC calendar month.
    - `runs_this_month` integer, required
    - `resets_at` string, date-time, required: First instant of the next UTC calendar month.
    - `plan_key` string, required: The workspace's current plan; free when it has none.
    - `next_plan` object, nullable, required: The cheapest plan above the current one that checks more emails a month; null when none or unlimited.
      - `plan_key` string, required
      - `label` string, required
      - `monthly_price_usd` number, required: Headline monthly price (yearly billing / 12).
      - `triage_run_limit` integer, required

---

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