# Get bounty

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

Retrieve a single bounty by id. With a private key, the response also includes a `progress` block: a page of every progress record on that bounty. The bounty itself is looked up by `bountyId` alone and is never paged, so exactly one bounty is always returned. With a public key, or with a private key and `includeProgress` set to the literal string `false`, the response has no `progress` block. Any other value of `includeProgress`, including `0`, still returns progress. If `bountyId` doesn't match a bounty visible to this creator group, this returns `404` with `BountyNotFound`. This does not check `endsAt`, so an ended bounty can still be retrieved.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Can be either private or public key. Response will vary based upon the key used.

## 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.
- `includeProgress` (boolean) - If set to the literal string `false`, progress is left out of the response. Any other value, including `0`, still includes it. Ignored entirely when using public key auth, since progress is never returned to a public key.
- `page` (integer) - Page of the `progress` list to return.
- `pageSize` (integer) - Page size for the `progress` list.

## Path parameters

- `bountyId` (string, required) - ID of bounty to retrieve

## Responses

### 200

Details of specified bounty

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

- `groupId` (string) - ID of the creator group
- `groupName` (string) - Name of the creator group
- `bounty` (object)
- `progress` (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)