Read individual user groups' AI credit usage
Organization Admin permissions are required to use this endpoint.
List AI credit usage for user groups (up to 1,000 unique user groups per request) for one billing period: the current UTC calendar month by default, or an earlier month named by the period field. Unknown, invalid, and duplicate IDs will fail the request.
Returns each user group’s credits used, in request order, plus the bounds of the period read. A user group’s usage is the sum of its current members’ usage for the period. User groups with no members or no usage in that period will report 0.
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Body
User groups to read usage for, at most 1000 per request. Each entry is a user group's ID. Use the List user groups endpoint to retrieve user group IDs. Each ID must be included only once.
1 - 1000 elementsUTC calendar month to read, as YYYY-MM. Omit it to read the current billing period. A month after the current one is rejected.
^20\d{2}-(0[1-9]|1[0-2])$"2026-09"
Response
Each requested user group's credit usage for the billing period read, in request order.
Start of the month after the billing period read, as a Unix ms timestamp (UTC calendar-month boundary, exclusive).
x >= 01790812800000
Start of the billing period read, as a Unix ms timestamp (UTC calendar-month boundary).
x >= 01788220800000

