Get usage
How many calls the team has used this period, out of how many and how many are left: per is the period (day during the trial, month on a plan, UTC), resets_at when the count starts again. MCP tool calls and API requests share this allowance. A team whose calls are not counted answers limit: null. Same answer as the MCP tool get_usage. Never counted against the allowance, as its MCP tool; the account still needs a plan (402 no_plan without one).
/api/v1/account/usageAuthentication
OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.
Response fields
planenumThe team's plan; a trial reads as its plan. One of
none,starter,growth,managed.usedinteger or nulllimitinteger or nullNull when the team's calls are not counted.
leftinteger or nullCalls left before a refusal: on a monthly plan, the fewer of the month's and today's (
today).perenumThe period: a day during the trial, a month on a plan (UTC);
lifefor the MCP preview of an account with no plan. One ofday,month,life,null.resets_atstring or null (date-time)When the count starts again; null when it never does.
exhaustedbooleanThe next counted call is refused: the period's calls, or today's ceiling on a monthly plan, are used.
todayobjectA monthly plan's daily ceiling: today's calls, its limit and when it resets (the next UTC midnight). Absent on the trial, the preview and a team that is not counted.
notestringplansstring (uri)The plans page.
Responses
- 200
Calls used and left this period. Body:
Usage. - 401
No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body:
Problem. - 402
no_plan: the account has no plan, and the API comes with one. Body:Problem. - 403
The token lacks mcp:read. Body:
Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.