# List tiers

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

Lists a creator group's revenue-share tiers, one page at a time, with each tier's current member count alongside its `revShare`.

This operation and the single-tier lookup below it are the only tier endpoints in this API. There is no way to create, edit, or delete a tier through it.

`memberCount` only counts members whose `attributionGroupTierId` is set to this tier, and defaults to `0` for a tier with none. The count has no member-status filter, so it includes members in every status, not just approved ones. It comes from a separate grouped count query, not from the tier row itself.

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

## Query parameters

- `groupId` (string) - Creator group to list tiers for. If your key is scoped to a single program, that group is always used regardless of this value; otherwise falls back to your default group when omitted.
- `page` (integer) - Defaults to 1 if omitted.
- `pageSize` (integer) - Maximum number of records to return. Defaults to 10 if omitted.

## Responses

### 200

list of tiers for the specified group

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

- `groupId` (string)
- `groupName` (string)
- `currentPage` (integer)
- `currentPageSize` (integer)
- `totalCount` (integer) - Total number of tiers on this group, not just this page.
- `groupTiers` (array of object)

### 400

bad input parameter