# List events

`GET https://api.nexus.gg/v1/bounties/event`

Returns one page of the events logged for a creator group's bounty program.

Each event includes the referring member's id and their own player id when the event's `referralCode` resolved, at the time the event was recorded, to an approved member of the group; both are left out when it didn't. This endpoint's own read query doesn't recheck membership status, so if that member's approval has since changed, their id still appears here.

Results are not explicitly ordered, so do not assume the most recent event comes first. Paging starts at `page` 1 and returns 100 events per page by default.

## Authorizations

- `X-SHARED-SECRET` (string, header, required)

## Query parameters

- `groupId` (string) - Creator group to use for this operation. 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

## Responses

### 200

Results matching criteria

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

- `groupId` (string) - ID of the creator group
- `groupName` (string) - Name of the creator group
- `currentPage` (integer) - Page number of response records returned
- `currentPageSize` (integer) - Page size used for this operation
- `totalCount` (integer) - Total number of events
- `events` (array of object)

### 400

Returned when `groupId` does not match a creator group on your publisher account.

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

- `code` (string) - CodeNotInGroup: Creator group is private, and specified code is not linked to it<br/> InvalidGroup: No creator group was found with the specified groupId<br/> InvalidAuthCode: AuthCode provided is not valid<br/> ExpiredAuthCode: AuchCode provided has expired<br/> ReferralNexusNotFound: No Nexus was found to match the provided referral code<br/> BountyNotFound: No bounty was found with the specified bountyId<br/> CreatorNotFound: No creator found with the specified creatorId<br/> InvalidEventCode: No event found with the specifed event code Allowed values: InvalidGroup, CodeNotInGroup, InvalidAuthCode, ExpiredAuthCode, ReferralNexusNotFound, BountyNotFound, MemberNotFound, InvalidEventCode, UnknownError.
- `message` (string)