---
title: "List groups"
method: GET
path: "/v1/account-groups"
tags: ["Account Groups"]
---

# List groups

`GET /v1/account-groups`

Returns all account groups visible to the authenticated user. Groups can
contain accounts from multiple profiles. For API keys scoped to specific
profiles, only groups whose accounts all live in allowed profiles are
returned.

## Response `200`

Groups

- object
  - `groups` object[]
    - `_id` string
    - `name` string
    - `accountIds` string[]
    - `createdBy` string
    - `profileId` string — Legacy field. Present only on groups created before cross-profile groups were supported. New groups omit it.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)