Users
Get credit usage for users in a space
Get credit usage for users in a space.
GET
Get credit usage for users in a space
The organization bot token must have the following scopes:
user:read
has_more and next_cursor to page through members.
Each result reports Notion credits, the unit your workspace is billed in. credits_used is the person’s usage in the current billing period, which metrics_period_start_ms and metrics_period_end_ms describe. total_credits_used is their usage across every billing period. Both include agents the person owns that run on their credits (credit_source: "owner"). That usage also appears in the agent’s own credit usage. Credits are whole credits, rounded down.
credit_limit is the member credit limit that applies to the person right now, or null when no limit applies. It’s 0 when the person has no limit and can’t use Notion credits until one is set. It limits Notion credits only. The response doesn’t say which setting the limit came from.
To see a person’s usage in past billing periods, use list credit usage per billing period for a user.
The request returns a 404 object_not_found error when 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
Query Parameters
Opaque continuation cursor from the previous page.
Minimum string length:
1Number of people per page (1–100; default 100).
Required range:
1 <= x <= 100Response
Always list
Allowed value:
"list"Always user_credit_usage
Allowed value:
"user_credit_usage"Current workspace members on this page, including members with no usage, ordered by user ID.
Maximum array length:
100Whether another page of people is available.
Opaque continuation cursor for the next page, or null when has_more is false.