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​

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