# Bounty rewards

`GET https://api.nexus.gg/v1/bounties/{bountyId}/rewards`

Same listing as getAllBountyRewards, scoped to one bounty via the `bountyId` path segment; both operations are served by the same handler. An unknown `bountyId` is rejected before the reward list is built.

Only rewards of type External are ever returned here, and the same `includeCompleted` semantics apply: pass it with any value, including `false`, to include already-completed rewards.

## 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) - Page size.
- `includeCompleted` (string) - Include already-completed rewards in the list. Presence of this parameter, with any value including `false`, includes them; omit it entirely to get only undelivered rewards.

## Path parameters

- `bountyId` (string, required) - The bounty to list rewards for.

## Responses

### 200

Rewards successfully retrieved

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

- `groupId` (string) - ID of the creator group
- `groupName` (string) - Name of the creator group
- `bountyId` (string) - Echoes the requested bounty.
- `currentPage` (integer) - Page number of response records returned
- `currentPageSize` (integer) - Page size used for this operation
- `totalCount` (integer) - Total number of referrals
- `rewards` (array of object)

### 404

Bounty Reward not found

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