> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.
# list_groups
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
Filter matched against the group name (case-insensitive substring) or, when
it is a valid ObjectId, against the group id.
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.
When True, return only archived groups; otherwise only active (non-archived)
groups.
Page size, between 1 and 250. Defaults to 50.
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
Deep link to open this group in the Qobra web app.
The group's stable key — the identifier used to match it when synced
from an integration, distinct from its display name.
Name of the dimension the group belongs to (the kind of grouping, e.g.
'Country' or 'Team'). Null if the dimension is unknown.
Number of users currently in the group (attributions active as of
today). Past and future members are excluded.