Skip to main content
GET
List Groups

Authorizations

Authorization
string
header
required

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

Query Parameters

integration_specific_id
string | null

Filters groups by integration specific ID, e.g. the group's Okta ID.

name
string | null

Filters groups by name.

exact_match
boolean
default:false

Search filter should be an exact match.

app_id
string | null

Filters groups by the ID of the app to which they belong.

page_token
string | null

Opaque cursor from a previous response's next_page_token. Omit to fetch the first page. Treat as opaque: do not decode, construct, or interpret it.

page_size
integer
default:100

Maximum number of items to return per page. Values above 1000 are clamped to 1000 rather than rejected.

Required range: x >= 1

Response

Successful Response

groups
Group · object[]
required

Groups returned in this page.

next_page_token
string | null

Token for the next page, or null when this is the last page. An absent token is the only end-of-results signal. A page holding fewer than page_size items does not mean the results are exhausted. Treat the value as opaque: do not decode, construct, or interpret it.