Check the status of a batch created with Bulk create events.
status starts at pending, moves to inProgress once a worker picks up the batch, then ends at complete once every submitted item has been attempted (whether or not each one individually succeeded), or at error if the worker itself throws while working through the batch.
errors lists the submitted items that failed, each paired with the operation payload as it was originally submitted; log lists the events that were created successfully. Both are left out of the response entirely when there is nothing to report, not returned as empty arrays.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Example
2ixlNNFdJh-9scoXek80wID of the bulk operation to check the status of
Query Parameters
Section titled “Query Parameters”Example
V1StGXR8_Z5jdHi6B1LiOCreator 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.
Responses
Section titled “ Responses ”Event Bulk Operation status
object
Batch items that failed validation or lookup during processing. Left out of the response entirely when nothing failed.
object
object
object
The code representing the event to be logged
Unique id of the player that the event pertains to
Optional code for the creator that referred this user
Events created successfully during processing. Left out of the response entirely when none were created.
object
ID of the generated event
Referral code the event was associated with
Player ID the event was associated with
Bulk Operation not found
object
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
const url = 'https://api.nexus.gg/v1/bounties/event/bulk/2ixlNNFdJh-9scoXek80w?groupId=V1StGXR8_Z5jdHi6B1LiO';const options = {method: 'GET', headers: {'X-SHARED-SECRET': 'nexus_sk_your_key_here'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.nexus.gg/v1/bounties/event/bulk/2ixlNNFdJh-9scoXek80w?groupId=V1StGXR8_Z5jdHi6B1LiO' \ --header 'X-SHARED-SECRET: nexus_sk_your_key_here'Example
{ "id": "2ixlNNFdJh-9scoXek80w", "status": "complete", "startedAt": "2026-03-13T17:32:28Z", "completedAt": "2026-03-13T17:34:52Z", "errors": [ { "message": "Invalid Event Code: reachLevel20", "operation": { "data": { "eventCode": "reachLevel20", "playerId": "player_8f2c41d0", "referralCode": "popcornfrog" } } } ], "log": [ { "id": "2ixlNNFdJh-9scoXek80w", "referralCode": "popcornfrog", "playerId": "player_8f2c41d0" } ]}Example
{ "code": "BulkOperationNotFound", "message": "Bulk Event Operation with id: 2ixlNNFdJh-9scoXek80w not found"}