Skip to main content
List the groups of your company, with filters and pagination. Groups are a secondary hierarchy organized by dimensions (a ‘Country’ dimension holds one group per country, and so on). Each row carries the group’s dimension and its current member count; use get_group for the full member list. Rows are ordered alphabetically by group name (A→Z).

Parameters

Body

Filter matched against the group name (case-insensitive substring) or, when it is a valid ObjectId, against the group id.
dimension
string
Filter to a single dimension (the kind of grouping, e.g. ‘Country’). Matched against the dimension name (case-insensitive substring) or, when it is a valid ObjectId, against the dimension id.
archived
boolean
When True, return only archived groups; otherwise only active (non-archived) groups.
limit
integer
Page size, between 1 and 250. Defaults to 50.
offset
integer
Row offset into the result set — the number of rows to skip before this page. Pass the next_offset returned by the previous call, or None for the first page.

Response

Body

groups
object[]
next_offset
integer