Read individual users' AI credit usage
Organization Admin permissions are required to use this endpoint.
List individual users’ (up to 1,000 unique users per request) AI credit usage for one billing period: the current UTC calendar month by default, or an earlier month named by the period field. Each user ID must belong to a current or removed member of the organization. Unknown, invalid, and duplicate IDs will fail the request.
Returns each user’s credits used, in request order, plus the bounds of the period read. Users with 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
Users to read usage for, at most 1000 per request. Each entry is a user's ID within this organization, whether a current or a removed member; each ID must be included only once. Duplicated IDs will result in an error.
1 - 1000 elementsUTC calendar month to read, as YYYY-MM, from 2000-01 to 2099-12. Omit it to read the current billing period. A month after the current one is rejected; a month before AI credit metering began reports 0 for every ID.
^20\d{2}-(0[1-9]|1[0-2])$"2026-09"
Response
Each requested user'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

