---
title: "Get a list of jobs"
slug: "get-a-list-of-jobs-1"
updated: 2025-11-21T01:09:48Z
published: 2025-11-21T01:09:59Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a list of jobs

Get/jobs

Retrieves a paginated list of jobs, optionally filtered by criteria such as batch, name, or status, and sorted by created or completed date.

SecurityAPI Key: WasabiAuthHeader parameter namex-amz-access-key

Wasabi access key for authenticating requests. A valid Wasabi User access key is required for API calls.

API Key: WasabiSecretAuthHeader parameter namex-amz-secret-key

Wasabi secret key for authenticating requests. A valid Wasabi User secret key is required along with the access key.

Query parameterspageNumberinteger

The page number to retrieve (default is 1).

Minimum1
pageSizeinteger

The number of jobs to return per page (default is 25).

Minimum1Maximum100Default100
batchstring

Filters jobs by the batch identifier.

statusstring

Filters jobs by status.

Valid values[
  "submitted",
  "preflight",
  "in_progress",
  "completed",
  "failed",
  "cancelled"
]
namestring

Filters jobs by the name identifier.

sortBystring

Sorts the results by the specified field.

Valid values[
  "Created"
]
sortOrderstring

Specifies the sort direction: ascending (`Asc`) or descending (`Desc`). Default is `Asc`.

Valid values[
  "Asc",
  "Desc"
]

Responses200

Job details retrieved successfully

<select class='api-response-data' aria-label='Media type'><option value='a7d7ae8c-d20a-4d5a-8bbe-eeb600edf704'>application/json</option>
</select>Expand Allobject  Records Array of object (JobList)   object  Idstring    

Unique ID for the job

Example67345137bcb6dce44b35a6a6281711e7
Namestring    

Name of the job

ExampleMyJobName
Sourceobject  Endpointstring    

S3 endpoint URL

Examples3.us-west-1.wasabisys.com
Bucketstring    

Source bucket name

Examplewasabifs-chm
Regionstring    

S3 region

Exampleus-west-1
ObjectKeystring    

Object key or path to the file

ExampleMP4/Commercial.mp4
Providerstring    

Storage provider, e.g., wasabi, OBS, IBM

UserIdstring    

User who submitted the job (e.g., an ARN)

Example10000
Createdstring  (date-time)    

Timestamp when the job was created

Example2024-11-13T07:11:51.658Z
Completedstring  (date-time)    

Timestamp when the job was completed

Example2024-11-13T07:11:51.658Z
Priorityinteger    

Job priority (1-10). example: 5

Batchstring    

Optional batch identifier for grouping jobs

Examplebatch_2024_11_21
Statusstring    

Current status of the job

Valid values[
  "submitted",
  "preflight",
  "in_progress",
  "completed",
  "failed",
  "cancelled"
]Examplesubmitted
Destinationobject  Bucketstring    

Destination bucket name

Exampleairstream-output-2
Regionstring    

S3 region

Exampleus-west-1

Paginationobject  TotalRecordsinteger    

Total number of jobs available.

Minimum0
PageNumberinteger    

Current page number.

PageSizeinteger    

Number of jobs per page.

400

Invalid request (e.g., parsing errors, missing/invalid fields, source/destination issues)

<select class='api-response-data' aria-label='Media type'><option value='ccbef792-f425-460c-8edf-3ff72c3957cd'>application/json</option>
</select>

```json
{
  "Error": "The limit on the number of rows allowed to query is %d!  Please adjust pageNumber and/or pageSize.",
  "ErrorCode": "BAD_REQUEST"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='968f8c88-0551-4c20-a0b9-400bf9228d4a'>application/json</option>
</select>

```json
{
  "Error": "Unauthorized",
  "ErrorCode": "UNAUTHORIZED"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

500

Internal Server Error

<select class='api-response-data' aria-label='Media type'><option value='3ab436ec-7f0d-469d-908c-d8d03c34a832'>application/json</option>
</select>

```json
{
  "Error": "An unexpected error occurred while processing the job.",
  "ErrorCode": "INTERNAL_ERROR"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR