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

# GET /jobs

`GET /jobs`

## Query parameters

- `ids` string[]
- `parent_job_id` string
- `status` 'submitted' | 'ready' | 'started' | 'canceled' | 'failed' | 'completed'
- `target` string
- `session_id` string
- `submitter_id` string
- `limit` integer
- `next` string

## Response `200`

Successfully retrieved a list of jobs.

- GetJobsResponse
  - `jobs` BaseJob[], required — List of jobs. Common fields are shown below; each entry's full per-type shape (with `settings`, `stats`, `output`, `results` documented by job type) is available on the [Get Job](/api-reference/v0.4/jobs/get-job) page.
    - `id` string, required
    - `status` 'submitted' | 'ready' | 'started' | 'canceled' | 'failed' | 'completed', required
    - `type` string, required
    - `backend` string, required
    - `dry_run` boolean, required
    - `submitter_id` string, required — The id of the user who submitted the job.
    - `project_id` string, nullable, required
    - `parent_job_id` string, nullable, required
    - `session_id` string, nullable, required
    - `metadata` JobMetadata, required
    - `name` string, nullable, required
    - `submitted_at` string, required
    - `started_at` string, required
    - `completed_at` string, required
    - `predicted_wait_time_ms` integer, nullable, required
    - `predicted_execution_duration_ms` integer, nullable, required
    - `execution_duration_ms` integer, nullable, required — How long the job actually took to run on the QPU. Null if the job hasn't run yet.
    - `shots` integer — `shots` are not included with ideal simulator backend.
    - `noise` Noise
      - `model` 'ideal' | 'harmony' | 'harmony-1' | 'harmony-2' | 'aria-1' | 'aria-2' | 'forte-1' | 'forte-enterprise-1', required
      - `seed` integer
    - `failure` Failure, required
      - `code` 'InvalidInput' | 'CompilationError' | 'ContractExpiredError' | 'DebiasingError' | 'InternalError' | 'NotEnoughQubits' | 'OptimizationError' | 'PreflightError' | 'QuantumCircuitComplexityError' | 'QuantumComputerError' | 'QuotaExhaustedError' | 'SimulationError' | 'SimulationTimeout' | 'SystemCancel' | 'TooLongPredictedExecutionTime' | 'TooManyControls' | 'TooManyGates' | 'TooManyShots' | 'UnknownBillingError' | 'UnsupportedGate', required
      - `message` string, required
    - `cost_model` 'QCT' | '2QGE_operations' — The billing model used for this job. `QCT` for jobs billed on quantum compute time, `2QGE_operations` for jobs billed on two-qubit gate operations.
    - `output` JsonObject, required
    - `settings` JsonObject, required
    - `stats` JsonObject, required
    - `results` JsonObject, required
  - `next` string, nullable, required

## Other responses

- `429` — Too Many Requests. To get a higher rate limit, please reach out to support@ionq.co
- `500` — A generic server failure, please reach out to support@ionq.co for help with this error
- `502` — Bad Gateway, this can be caused by misbehaving proxies, or by service issues. These can be retried, and downtime can be found on status.ionq.co
- `503` — Service Unavailable, this is indicative of service outage, please check status.ionq.co

---

[API](https://skmtc.net/ionq/apis/ionq-cloud-platform-api.md) · [All operations](https://skmtc.net/ionq/apis/ionq-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ionq/ionq-cloud-platform-api/versions/0410071e1cd0/schema)