# Bulk event status

`GET https://api.nexus.gg/v1/bounties/event/bulk/{bulkOperationId}`

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

- `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.

## Path parameters

- `bulkOperationId` (string, required) - ID of the bulk operation to check the status of

## Responses

### 200

Event Bulk Operation status

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

- `id` (string)
- `status` (string)
- `startedAt` (string)
- `completedAt` (string)
- `errors` (array of object) - Batch items that failed validation or lookup during processing. Left out of the response entirely when nothing failed.
- `log` (array of object) - Events created successfully during processing. Left out of the response entirely when none were created.

### 404

Bulk Operation 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)

```json
{
  "code": "BulkOperationNotFound",
  "message": "Bulk Event Operation with id: 2ixlNNFdJh-9scoXek80w not found"
}
```