# List groups

`GET https://api.nexus.gg/v1/manage/groups`

Lists every creator group on your publisher account, each with its id, name, and default flag.

The response is not paginated: every group your publisher owns comes back in one call, regardless of how many there are.

This endpoint takes no `groupId` parameter and ignores an API key's own group scope. It always lists across the whole publisher account, not just the key's assigned group.

A group's `id` here is the same value other endpoints call `groupId`, use it there when your program runs more than one creator group.

**NOTE**: This method uses a **secret** (`nexus_sk_...`) API key and should never be called from or embedded into the gaming client. These routes should ONLY be accessed from your back-end services.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Send your **secret** API key (`nexus_sk_...`) in the `X-SHARED-SECRET` header. [Generate one](/authentication/api-keys/) in the Publisher Dashboard.

## Responses

### 200

Every creator group on your publisher account. There is no paging: all groups come back in a single call.

#### Body (`application/json`)

- `groups` (array of object)

### 400

bad input parameter