---
title: "ListBulkOpsRequests"
method: GET
path: "/bulk-ops-requests"
tags: ["Bulk Ops Requests"]
---

# ListBulkOpsRequests

`GET /bulk-ops-requests`

Fetch a list of bulk operations requests.

## Query parameters

- `status` 'IN_PROGRESS' | 'FAILED' | 'SUCCEEDED'
- `startRequestedAt` string
- `endRequestedAt` string
- `pageLimit` number, double
- `pageNextToken` string — If available in the initial response, use this token to retrieve the next page of items in the list. When supplying as a request parameter, use URL-encoding.

## Response `200`

Ok

- PaginatedResultBulkOpsRequestDetails
  - `items` BulkOpsRequestDetails[], required
    - `bulkOpsRequestId` string, required — Universally Unique Lexicographically Sortable Identifier (using Crockford's alphabet).
    - `endpoint` 'REGISTER_PUBLIC_KEYS' | 'REGISTER_CERTIFICATES' | 'ONBOARD_DEVICES', required
    - `status` 'IN_PROGRESS' | 'FAILED' | 'SUCCEEDED', required
    - `requestedAt` string, date-time, required — HTML-encoded ISO-8601 date-time string denoting the start or end of a date range. If the string includes only a date, the time is the beginning of the day (00:00:00).
    - `completedAt` string, date-time — HTML-encoded ISO-8601 date-time string denoting the start or end of a date range. If the string includes only a date, the time is the beginning of the day (00:00:00).
    - `uploadedDataUrl` string, required — The URL at which you can retrieve the data you originally uploaded to an endpoint that supports bulk operations.
    - `errorSummaryUrl` string — The URL at which you can retrieve a summary of errors and the row indices they occurred at for a failed bulk ops request job.
  - `total` integer — Reflects the total results returned by the query, which may be less than the total number of items available. If the response contains a `pageNextToken` value, you can supply the `pageNextToken` in the next request to get more results. The maximum value of `total` is the page limit of the request, or ten pages if no page limit is provided.
  - `pageNextToken` string — Token used to retrieve the next page of items in the list. Present in a response only if the total available results exceeds the specified limit on a page. This token does not change between requests. When supplying as a request parameter, use URL-encoding.

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)