Skip to main content
GET
/
jobs
cURL
# Get all jobs:
curl "https://api.ionq.co/v0.4/jobs" \
  -H "Authorization: apiKey your-api-key"
{
  "jobs": [
    {
      "id": "e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524",
      "status": "completed",
      "type": "ionq.circuit.v1",
      "backend": "simulator",
      "dry_run": false,
      "submitter_id": "64b03577072d45001c85e9c4",
      "project_id": "1333d459-cf47-4a5e-acc1-8d4eb4f7b025",
      "parent_job_id": null,
      "session_id": null,
      "metadata": null,
      "name": null,
      "submitted_at": "2025-05-28T20:47:05.440Z",
      "started_at": null,
      "completed_at": null,
      "predicted_execution_duration_ms": null,
      "predicted_wait_time_ms": null,
      "execution_duration_ms": null,
      "shots": 1000,
      "noise": {
        "model": "ideal"
      },
      "failure": null,
      "settings": {
        "compilation": {}
      },
      "stats": {
        "qubits": 20,
        "circuits": 1,
        "gate_counts": {
          "1q": 1028,
          "2q": 110
        },
        "predicted_quantum_compute_time_us": 5000,
        "billed_quantum_compute_time_us": 5200
      },
      "results": {
        "probabilities": {
          "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities"
        }
      },
      "output": {}
    }
  ],
  "next": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.ionq.com/llms.txt

Use this file to discover all available pages before exploring further.

List all jobs in your project with optional filtering by job status (submitted, ready, started, canceled, failed, completed). This provides a paginated overview of your job history including basic metadata and timing information for each job.

Authorizations

​
Authorization
string
header
required

API keys are associated with a user and can be created on the IonQ Quantum Cloud application. To authenticate, prefix your API Key with apiKey and place it in the Authorization request header. Ex: Authorization: apiKey your-api-key

Query Parameters

​
ids
string[]
​
parent_job_id
string
​
status
enum<string>
Available options:
submitted,
ready,
started,
canceled,
failed,
completed
​
target
string

Filter jobs by backend target. Supports single target or comma-separated list of targets.

​
session_id
string
​
submitter_id
string

The id of another user within a shared project to view their submitted jobs. Ignored if not a project member.

​
limit
integer<int32>
​
next
string

Response

Successfully retrieved a list of jobs.

​
jobs
object[]
required
​
next
string | null
required