# Get tier

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

Returns one tier's detail, including its `revShare`, together with one page of the group members currently assigned to it.

Only members with `status = Approved` are included. A pending or removed member assigned to this tier never appears in this list.

Each member's `codes` array covers every Nexus node linked to that creator, not just their primary one. Their `playerId` and `playerMetadata` echo the member's stored `externalRef` and `externalMetadata`, the same values you supplied when the member was created or later linked to a player.

This tier's `revShare` is returned as a fraction here (`0.2` for a 20% tier), not the percentage `getCreatorGroupTiers` returns for the same tier (`20`).

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

## Path parameters

- `tierId` (string, required) - The tier's `uuid` (`CreatorGroupTier.uuid`).

## Query parameters

- `groupId` (string) - Creator group the tier belongs to. 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.

## Responses

### 200

Creator Group Tier matching the specified id

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

- `groupId` (string)
- `groupName` (string)
- `id` (string)
- `name` (string)
- `revShare` (number) - This tier's revenue-share rate as a fraction (0 to 1), for example 0.2 for 20%. Unlike the tiers list endpoint, this value is not converted to a percentage.
- `currentPage` (integer)
- `currentPageSize` (integer)
- `totalCount` (integer) - Total number of approved members on this tier, not just this page.
- `members` (array of object)

### 404

`groupId` did not match a creator group on your account, or `tierId` did not match a tier on that group.