Skip to content
Docs

List events

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

Section titled “Authorizations”
X-SHARED-SECRET
required
stringheader

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
groupId
string
Example
V1StGXR8_Z5jdHi6B1LiO

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 format: int32
default: 1 >= 1 <= 9999

Page of records to return

pageSize
integer format: int32
default: 100 >= 1 <= 100

Maximum number of records to return

Responses

Section titled “ Responses ”

200

Section titled “200”

Results matching criteria

Media typeapplication/json
object
groupId

ID of the creator group

string
groupName

Name of the creator group

string
currentPage

Page number of response records returned

integer format: int32
currentPageSize

Page size used for this operation

integer format: int32
totalCount

Total number of events

integer format: int32
events
Array
object
id

ID of the event

string
eventDate
string format: date-time
eventCode

Event code

string
playerId

Unique identier of the in game user that triggered this event

string
referralCode

Referral code used by the player that triggered this event

string
memberId

ID of the member that this referralCode is associated with

string
memberPlayerId

Unique identifier of the in game user that the referral code is associated with

string

400

Section titled “400”

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

Media typeapplication/json
object
code

CodeNotInGroup: Creator group is private, and specified code is not linked to it
InvalidGroup: No creator group was found with the specified groupId
InvalidAuthCode: AuthCode provided is not valid
ExpiredAuthCode: AuchCode provided has expired
ReferralNexusNotFound: No Nexus was found to match the provided referral code
BountyNotFound: No bounty was found with the specified bountyId
CreatorNotFound: No creator found with the specified creatorId
InvalidEventCode: No event found with the specifed event code

string
Allowed values: InvalidGroup CodeNotInGroup InvalidAuthCode ExpiredAuthCode ReferralNexusNotFound BountyNotFound MemberNotFound InvalidEventCode UnknownError
message
string
GET
/event
curl --request GET \
  --url 'https://api.nexus.gg/v1/bounties/event?groupId=V1StGXR8_Z5jdHi6B1LiO&page=1&pageSize=100' \
  --header 'X-SHARED-SECRET: nexus_sk_your_key_here'
Example
{
  "groupId": "V1StGXR8_Z5jdHi6B1LiO",
  "groupName": "Aurora Drift Creators",
  "currentPage": 1,
  "currentPageSize": 100,
  "totalCount": 15,
  "events": [
    {
      "id": "2ixlNNFdJh-9scoXek80w",
      "eventDate": "2026-03-13T17:32:28Z",
      "eventCode": "lvl20",
      "playerId": "player_8f2c41d0",
      "referralCode": "popcornfrog",
      "memberId": "9jd7RBR_B2BZ0uWO3_lgv",
      "memberPlayerId": "2ixlNNFdJh-9scoXek80w"
    }
  ]
}