Skip to main content
GET
Get credit usage for a user in a space
The organization bot token must have the following scopes:
  • user:read
Returns one person’s Notion credit usage per billing period, starting with the current billing period and going back in time. The first result is the current billing period. Returns up to 100 periods per page by default; use 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

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

user_id
string<uuid>
required

User ID of the workspace member.

space_id
string<uuid>
required

Query Parameters

start_cursor
string

Opaque continuation cursor from the previous page.

page_size
integer

Number of billing periods 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_period

Allowed value: "user_credit_usage_period"
results
object[]
required

This person's usage per monthly billing period, newest first.

Maximum array length: 100
has_more
boolean
required

Whether older billing periods are available.

next_cursor
string | null
required

Cursor for the next page of billing periods, or null when has_more is false.