Skip to main content
GET
List group members
The organization bot token must have the following scopes:
  • permission-group:read
Returns direct user memberships for admin-managed and SCIM-managed groups. Nested-group memberships are not included. Each membership’s role is either owner or member.

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

group_id
string
required

The ID of the group.

space_id
string<uuid>
required

Query Parameters

page_size
integer

Number of memberships to return (1–100; default 100).

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

Opaque continuation cursor from a previous page.

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always group_membership

Allowed value: "group_membership"
results
object[]
required

The direct user memberships in the group.

Maximum array length: 100
has_more
boolean
required

Whether another page is available.

next_cursor
string | null
required

Cursor for the next page, or null on the last page.