# Get Bulk Job Status

> GET `/secure/bulkpaymentrequests/getbulkjobbyreference`
> Part of the Payments API reference. Source: https://hub.ozow.com/api-reference/payments-api/get-secure-bulkpaymentrequests-getbulkjobbyreference/

Server: `https://api.ozow.com` (Production)

Other environments: `https://stagingapi.ozow.com` (Staging)

The status of a bulk job, by the job reference used when it was created. Limited to a seven day window.

## Authentication

- `BearerToken` (HTTP bearer)
  - The token generated by the `Get API token` operation. The same token is used for every request until it expires.

## Query parameters

- `reference` (string, required) - Use the Job Reference that was used when creating a new bulk job via Create endpoint

## Responses

### 200 OK

array of BulkJobStatus

### 400 Bad Request. The operation could not be carried out. The body is a message rather than a structured error.

string

Example (example 1):

```json
There was an error processing your request
```

### 401 Unauthorized. The `ApiKey` header is missing or does not match the site, or for a `Secure` operation the bearer token is missing, expired or invalid.

string

Example (example 1):

```json
API key is missing or invalid.
```