Organisation AI usage breakdown (subscription page parity)
GET /api/v3/organizations/{organisation}/ai/usage
GET
/api/v3/organizations/{organisation}/ai/usage
AI usage from the subscription page’s source (cloud-api monthly-usage). Parameterized by month, groupBy (model|user|token) and optional daily series. NOTE: as of API 4.19.0 this endpoint requires the update_subscription permission + subscription:read scope (previously use_ai_services + ai:use). For per-caller spend use /ai/usage/me.
Authorizations
Parameters
Path Parameters
organisation
required
string
Query Parameters
month
string
YYYY-MM, defaults to current month
groupBy
string
include
string
Set to ‘daily’ to append a 30-day series
userId
string
Scope the daily series to a user
tokenId
string
Scope the daily series to a token
Responses
200
Usage breakdown
403
Missing update_subscription permission or subscription:read scope
422
Invalid groupBy
500
Failed to fetch usage data