# List rev shares

`GET https://api.nexus.gg/v1/manage/scheduled-rev-shares`

Returns one page of the scheduled revenue-share overrides for a creator group, most recent `startDate` first.

Each entry's `status` tells you whether it is `Active`, `Scheduled` (starts in the future), or `Ended` (already finished). This is computed against the current time on every call, not stored on the row.

A schedule can carry a flat group-wide `revShare`, a set of per-tier overrides in `tierRevenueShares`, or both. If a schedule only has tier overrides, its top-level `revShare` in the response is not `0` or absent, it falls back to the group's normal, non-scheduled default. Do not read a non-zero `revShare` here as proof a group-wide override is active for that schedule.

A `page` below 1 or an unparsable `pageSize` return `400`.

If your API key is scoped to a single program, that key's group is always used regardless of the `groupId` you pass.

## 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 schedules 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) - page of records to return
- `pageSize` (integer) - Maximum number of records to return. Defaults to 10 if omitted.

## Responses

### 200

list of scheduled rev shares for the specified group

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

- `groupId` (string)
- `groupName` (string)
- `currentPage` (integer)
- `currentPageSize` (integer)
- `totalCount` (integer) - Total number of scheduled revenue shares for this group, not just this page.
- `scheduledRevShares` (array of object)

### 400

bad input parameter