Skip to main content
List the group dimensions of your company, with filters and pagination. A dimension is a kind of grouping — ‘Country’, ‘Team’, ‘Segment’ — and each holds one group per value (the ‘Country’ dimension holds one group per country). Reach for this to discover which dimensions exist before filtering list_groups by one; each row carries the dimension’s current group count. Rows are ordered alphabetically by dimension name (A→Z).

​
Parameters

Body

​
string
Filter matched against the dimension name (case-insensitive substring) or, when it is a valid ObjectId, against the dimension id.
​
boolean
When True, return only archived dimensions; otherwise only active (non-archived) dimensions.
​
integer
Page size, between 1 and 250. Defaults to 50.
​
integer
Row offset into the result set — the number of rows to skip before this page. Any offset >= 0 is accepted; it does not have to be a multiple of limit, so you can start from an arbitrary row. Pass the next_offset returned by the previous call to walk the pages, or None for the first page.

​
Response

Body

​
object[]
​
integer