---
title: "GET /jobs"
method: GET
path: "/jobs"
---

# GET /jobs

`GET /jobs`

Retrieves a paginated list of bulk import job requests. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ListBulkImportJobs.html">List bulk import jobs (CLI)</a> in the <i>IoT SiteWise User Guide</i>.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `filter` 'ALL' | 'PENDING' | 'RUNNING' | 'CANCELLED' | 'FAILED' | 'COMPLETED_WITH_FAILURES' | 'COMPLETED'

## Response `200`

Success

- ListBulkImportJobsResponse
  - `jobSummaries` JobSummary[], required — One or more job summaries to list.
    - `id` string, required — The ID of the job.
    - `name` string, required — The unique name that helps identify the job request.
    - `status` 'PENDING' | 'CANCELLED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_FAILURES', required — <p>The status of the bulk import job can be one of following values.</p> <ul> <li> <p> <code>PENDING</code> – IoT SiteWise is waiting for the current bulk import job to finish.</p> </li> <li> <p> <code>CANCELLED</code> – The bulk import job has been canceled.</p> </li> <li> <p> <code>RUNNING</code> – IoT SiteWise is processing your request to import your data from Amazon S3.</p> </li> <li> <p> <code>COMPLETED</code> – IoT SiteWise successfully completed your request to import data from Amazon S3.</p> </li> <li> <p> <code>FAILED</code> – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.</p> </li> <li> <p> <code>COMPLETED_WITH_FAILURES</code> – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.</p> </li> </ul>
  - `nextToken` string — The token for the next set of results, or null if there are no additional results.

## Other responses

- `480` — InvalidRequestException
- `481` — InternalFailureException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iotsitewise.md) · [All operations](https://skmtc.net/aws/apis/iotsitewise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotsitewise/versions/d13e5d3e0a6f/schema)