Get plan and usage
The current plan, posts used this UTC month, and connected-account allowance.
GET
/api/cli/usageAuthorization
AuthorizationBearer token (ba_sk_...) · headerrequiredAPI key from /dashboard/api-keys. Keys expire after 365 days.
or
AuthorizationBearer token (ba_mcp_access_...) · headerrequiredThe OAuth access token the hosted MCP server issues (brainy:read for GET routes, brainy:write for everything else). One login serves MCP, the CLI and the desktop app. A token without the needed scope gets 403 Insufficient scope.
Responses
200
OK
planstringPlan or entitlement name, such as Free, Creator, or Pro
billing_enabledbooleanpostsobjectShow propertiesHide properties
limitinteger | nullnull means unlimited
usedintegerremaininginteger | nullperiodstringresets_atstring<date-time>social_accountsobjectShow propertiesHide properties
limitinteger | nullusedintegerremaininginteger | nullsubscriptionobject | nullupgrade_urlstring<uri>plansobject[]401
Missing, invalid, expired, or revoked API key
errorstringrequiredcodestring