Skip to content

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).

get/api/v1/account/usage

Authentication

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

  • planenum

    The team's plan; a trial reads as its plan. One of none, starter, growth, managed.

  • usedinteger or null

  • limitinteger or null

    Null when the team's calls are not counted.

  • leftinteger or null

    Calls left before a refusal: on a monthly plan, the fewer of the month's and today's (today).

  • perenum

    The period: a day during the trial, a month on a plan (UTC); life for the MCP preview of an account with no plan. One of day, month, life, null.

  • resets_atstring or null (date-time)

    When the count starts again; null when it never does.

  • exhaustedboolean

    The next counted call is refused: the period's calls, or today's ceiling on a monthly plan, are used.

  • todayobject

    A 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.

  • notestring

  • plansstring (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.