Skip to main content
GET
List credit access policies
The organization bot token must have the following scopes:
  • credit-limit-policy:read
A credit access policy sets how many Notion credits members can use. Each policy has a limit: no_access, limited with a number of credits, or unlimited. To decide who a policy covers, create a credit access assignment. This endpoint lists every policy in the workspace. Use has_more and next_cursor to page through policies.

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

page_size
integer

Number of results per page, from 1 through 100. Defaults to 100.

Required range: 1 <= x <= 100
start_cursor
string

The next_cursor value from the previous page.

Maximum string length: 4096

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always credit_access_policy

Allowed value: "credit_access_policy"
results
object[]
required
Maximum array length: 100
has_more
boolean
required

Whether more results are available.

next_cursor
string | null
required

Pass as start_cursor to get the next page. null on the last page.