> ## 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.

# get_group

Return a single group with its full member list.

Beyond the group's identity (name, key, dimension), the result joins in every
user attribution — past and present — as an email plus a `YYYY-MM` membership
window; a null departure means the membership is still ongoing.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="identifier" type="string" required>
    The group to look up. Either the group's ObjectId, or a free-text search
    matched against the group name (same matching as list\_groups). The search
    must resolve to exactly one group — a name fragment is fine; an ambiguous
    term that matches several groups is rejected with a clear error.
  </ParamField>

  <ParamField body="dimension" type="string">
    Optional dimension to disambiguate the lookup when the same name exists in
    several dimensions (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.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="id" type="string" />

  <ResponseField name="resource_url" type="string">
    Deep link to open this group in the Qobra web app.
  </ResponseField>

  <ResponseField name="name" type="string" />

  <ResponseField name="key" type="string">
    The group's stable key — the identifier used to match it when synced from an
    integration, distinct from its display name.
  </ResponseField>

  <ResponseField name="dimension" type="string">
    Name of the dimension the group belongs to (the kind of grouping, e.g.
    'Country' or 'Team'). Null if the dimension is unknown.
  </ResponseField>

  <ResponseField name="archived" type="boolean" />

  <ResponseField name="member_count" type="integer">
    Number of users currently in the group (attributions active as of today).
    Past and future members are excluded.
  </ResponseField>

  <ResponseField name="members" type="object[]">
    Every user attribution on the group, past and present, each with its
    membership window. A user with several stints appears once per attribution.

    <Expandable title="object properties">
      <ResponseField name="email" type="string" />

      <ResponseField name="arrival_date" type="string">
        YYYY-MM; the month the user joined the group.
      </ResponseField>

      <ResponseField name="departure_date" type="string">
        YYYY-MM; null while the membership is still ongoing.
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>