Users
Get credit usage for a user in a space
Get credit usage for a user in a space.
GET
Get credit usage for a user in a space
The organization bot token must have the following scopes:
user:read
has_more and next_cursor to get older periods.
credits_used is the person’s usage in the period, in whole Notion credits, rounded down. It includes agents the person owns that run on their credits (credit_source: "owner"). That usage also appears in the agent’s own credit usage.
The request returns a 404 object_not_found error when the user isn’t a current member of the workspace or the workspace has no billing period.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The Admin API version to use for this request.
Available options:
2026-06-01 Path Parameters
User ID of the workspace member.
Query Parameters
Opaque continuation cursor from the previous page.
Number of billing periods per page (1–100; default 100).
Required range:
1 <= x <= 100Response
Always list
Allowed value:
"list"Always user_credit_usage_period
Allowed value:
"user_credit_usage_period"This person's usage per monthly billing period, newest first.
Maximum array length:
100Whether older billing periods are available.
Cursor for the next page of billing periods, or null when has_more is false.