Skip to main content
GET
Get credit usage for users in a space
The organization bot token must have the following scopes:
  • user:read
Lists every current member of the workspace, including members with no usage, ordered by user ID. Use 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

space_id
string<uuid>
required

Query Parameters

start_cursor
string

Opaque continuation cursor from the previous page.

Minimum string length: 1
page_size
integer

Number of people per page (1–100; default 100).

Required range: 1 <= x <= 100

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always user_credit_usage

Allowed value: "user_credit_usage"
results
object[]
required

Current workspace members on this page, including members with no usage, ordered by user ID.

Maximum array length: 100
has_more
boolean
required

Whether another page of people is available.

next_cursor
string | null
required

Opaque continuation cursor for the next page, or null when has_more is false.