Skip to content

Get AI usage summary for the authenticated user

GET
/api/v3/organizations/{organisation}/ai/usage/me

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

Responses

200

User AI usage summary

object
userId
string
currentMonth
string
2026-03
monthly
object
spendCents
integer
requestCount
integer
daily
object
spendCents
integer
quota
object
monthlyLimit

Per-user monthly spend cap (object form, present when an org-level perUserMonthlyBudget is configured)

object
limitCents

The configured monthly cap in US cents

integer
usedPercent

Percentage of the cap consumed this month (0–100+)

number format: float
remainingCents

Cents remaining before the cap is hit; can be negative if overspent

integer
dailyLimit

Per-user daily spend cap (object form, present when an org-level perUserDailyBudget is configured)

object
limitCents

The configured daily cap in US cents

integer
usedPercent

Percentage of the cap consumed today (0–100+)

number format: float
remainingCents

Cents remaining before the cap is hit; can be negative if overspent

integer
resetsAt

UTC timestamp when the daily counter resets (always next UTC midnight)

string format: date-time

401

Cannot determine caller identity

500

Failed to retrieve usage data