Usage
The live usage rollup for the current period, and your month-by-month history
partnerUsageSummary
partnerUsageSummary: PartnerUsageSummary!PARTNER_ADMIN, tech providers only.
Returns the live usage rollup for the current billing period. Takes no arguments.
Returns PartnerUsageSummary!
| Field | Type | Description |
|---|---|---|
children | Int! | Number of client orgs counted in this rollup. |
opsUnits | Int! | Metered operational units consumed this period. |
aiUnits | Int! | Metered AI units consumed this period. |
estimatedAmountCents | Int! | Estimated charge for the period so far, in cents. Nets off your allowance bank and applies your monthly minimum. |
currency | String! | The currency estimatedAmountCents is expressed in. |
opsAllowanceRemaining | Float! | Projected ops allowance left in your bank if the period closed now. |
aiAllowanceRemaining | Float! | The same for AI units. |
Example
query Usage {
partnerUsageSummary {
children
opsUnits
aiUnits
opsAllowanceRemaining
aiAllowanceRemaining
estimatedAmountCents
currency
}
}{
"data": {
"partnerUsageSummary": {
"children": 14,
"opsUnits": 48210,
"aiUnits": 3907,
"opsAllowanceRemaining": 0,
"aiAllowanceRemaining": 1093,
"estimatedAmountCents": 51840,
"currency": "usd"
}
}
}opsUnits and aiUnits are total usage, not billable usage. Your included allowance is a rolling bank that carries unused units forward, and it is netted off only when the charge is computed - so these numbers can far exceed what you are billed on. Read opsAllowanceRemaining / aiAllowanceRemaining for what is left in the bank, and estimatedAmountCents for what you will pay.
partnerUsageHistory
partnerUsageHistory: [TechProviderMonthlyUsage!]!PARTNER_ADMIN, tech providers only.
Your month-by-month usage history, for the periods that have closed. partnerUsageSummary covers the period in progress; this covers the ones behind it. Takes no arguments.
Returns [TechProviderMonthlyUsage!]!
| Field | Type | Description |
|---|---|---|
periodEnd | DateTime! | The period this row covers. |
opsUsed | Float! | Total ops used in that period. |
aiUsed | Float! | Total AI units used in that period. |
Example
query History {
partnerUsageHistory { periodEnd opsUsed aiUsed }
}{
"data": {
"partnerUsageHistory": [
{ "periodEnd": "2026-09-15T00:00:00.000Z", "opsUsed": 44120, "aiUsed": 3310 },
{ "periodEnd": "2026-08-15T00:00:00.000Z", "opsUsed": 39870, "aiUsed": 2905 }
]
}
}Usage only - no charged amount. These are the totals your clients consumed, with the allowance bank not netted off. For what you were actually charged, use your invoices.
The numbers move during the period and estimatedAmountCents is an estimate, not an invoice. How units are counted and billed - the rolling allowance bank, the monthly minimum, and your billing day - is in Billing.