---
title: "Listar Grupos de um Usuário"
method: GET
path: "/groups_of/{employment_id}/"
tags: ["Grupo"]
---

# Listar Grupos de um Usuário

`GET /groups_of/{employment_id}/`

Obtém a lista de grupos de um usuário específico.

## Path parameters

- `employment_id` integer, required

## Query parameters

- `cursor` string
- `secret` string, required
- `q` string

## Response `200`

Lista de grupos do usuário

- object
  - `next_cursor` string — Cursor para a próxima página de resultados
  - `prev_cursor` string — Cursor para a página anterior de resultados
  - `results` object[]
    - `id` integer — Identificador do grupo
    - `name` string — Nome do grupo
    - `description` string — Descrição do grupo
    - `created_at` string, date-time — [formatted datetime string] data/hora de criação desse grupo
    - `created_at_i18n` string — [formatted datetime string] data/hora de criação desse grupo em formato local

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/versions/3f26defa2a42/schema)