Skip to main content

Get consumption (admin)

Read consumption (credits + tool calls) for the calling org. Without user_id: org-wide ConsumptionStatus. With user_id: per-user breakdown. Requires an admin-scoped API key.

Parameters

NameTypeRequiredDefaultDescription
user_idstring❌ No-Optional UUID of a user. If provided, returns a per-user breakdown for that user. If omitted, returns the org-wide consumption status.
fromstring❌ No-ISO datetime; window start (default: org's current billing period start).
tostring❌ No-ISO datetime; window end (default: org's current billing period end).