---
title: "Get All Jobs"
method: GET
path: "/jobs"
tags: ["jobs"]
---

# Get All Jobs

`GET /jobs`

Retrieve a paginated list of quantum jobs for the authenticated user.

**Query Parameters:**
- **vendor** (string, optional): Filter by vendor (e.g., `aws`, `ibm`, `qbraid`, or `all`)
- **provider** (string, optional): Filter by provider name
- **statusGroup** (string, optional): Filter by status group — `pending`, `returned`, or `all`
- **status** (string, optional): Filter by individual job status (takes priority over `statusGroup`)
- **search** (string, optional): Search jobs by keyword (1–255 characters)
- **tags** (string, optional): Filter by tags as a JSON object (e.g., `{"env":"prod"}`)
- **page** (integer, optional): Page number (default: 1)
- **limit** (integer, optional): Items per page, max 100 (default: 50)

**Returns:**
- Paginated array of RuntimeJob objects with pagination metadata

**Raises:**
- **401**: Authentication required
- **422**: Validation error if query parameters are invalid

## Query parameters

- `vendor` 'aws' | 'azure' | 'ibm' | 'ionq' | 'qbraid' | 'all' — Filter jobs by vendor
- `provider` string — Filter jobs by provider name
- `statusGroup` 'all' | 'pending' | 'returned' — Filter by status group
- `status` 'INITIALIZING' | 'QUEUED' | 'VALIDATING' | 'RUNNING' | 'CANCELLING' | 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'UNKNOWN' | 'HOLD' — Filter by individual job status
- `search` string — Search keyword
- `tags` string — JSON object of tag key-value pairs to filter by
- `page` integer — Page number (1-indexed)
- `limit` integer — Number of items per page

## Response `200`

Successful Response

- ListJobsResponse — Paginated response for listing user jobs
  - `success` boolean, required
  - `data` RuntimeJob[], required — Array of jobs matching the query filters
    - `name` string, nullable — Job name
    - `shots` integer, required — Number of shots to execute
    - `deviceQrn` string, required — qBraid device resource name
    - `tags` object — Job tags
    - `runtimeOptions` object — Runtime options
    - `jobQrn` string, required — qBraid job resource name
    - `batchJobQrn` string, nullable — Batch job resource name
    - `vendor` 'aws' | 'azure' | 'ibm' | 'ionq' | 'qbraid', required — Vendor name
    - `provider` 'aqt' | 'aws' | 'azure' | 'equal1' | 'ibm' | 'iqm' | 'ionq' | 'nec' | 'oqc' | 'pasqal' | 'quantinuum' | 'quera' | 'rigetti' | 'qbraid', required — Provider name
    - `status` string, required — Job status
    - `statusMsg` string, nullable — Job status message
    - `experimentType` string, required — Experiment type
    - `queuePosition` integer, nullable — Job queue position
    - `timeStamps` TimeStamps — Model for capturing time-related information in an experiment.
      - `createdAt` string, date-time, required
      - `endedAt` string, date-time, nullable
      - `executionDuration` integer, nullable — Execution time in milliseconds
    - `cost` number, nullable — Job cost in credits
    - `estimatedCost` number, nullable, required — Job estimated cost in credits
    - `metadata` object — Job metadata
  - `pagination` object, required
    - `page` integer, required — Current page number
    - `limit` integer, required — Number of items per page
    - `total` integer, required — Total number of jobs
    - `totalPages` integer, required — Total number of pages
    - `hasNext` boolean, required — Whether a next page exists
    - `hasPrev` boolean, required — Whether a previous page exists
  - `meta` object, required
    - `timestamp` string, date-time, required — Response timestamp

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.net/qbraid/apis/qbraid-runtime-api.md) · [All operations](https://skmtc.net/qbraid/apis/qbraid-runtime-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qbraid/qbraid-runtime-api/versions/6e818ad19cde/schema)