---
title: "List groups and the membership of the groups"
method: GET
path: "/groups-report"
tags: ["Groups"]
---

# List groups and the membership of the groups

`GET /groups-report`

The list of group memebership with the following fields:
  * group description
  * group member user email
Format is JSON by default or csv format if Request Header Accept 'text/csv' is specified.

Included on report: groups acting as a role (i.e. publishers, admin)
Excluded from Report: groups that are empty of users

## Headers

- `Accept` 'application/json' | 'text/csv'

## Response `200`

The list of groups and members

- GroupUser[] — A list of group descriptions and members emails
  - `group` string — The group description
  - `user` string — The user email

## Other responses

- `401` — Authentication information is missing or invalid
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.net/office-of-national-statistics/apis/identity-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/identity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/identity-api/revisions/6472459b6b03/schema)