GET
/
jobs
# 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
        }
      },
      "results": {
        "probabilities": {
          "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities"
        }
      },
      "output": {}
    }
  ],
  "next": null
}

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
​
limit
integer
​
next
string

Response

200 - application/json

Successfully retrieved a list of jobs.

The response is of type object.

GET
/
jobs
# 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
        }
      },
      "results": {
        "probabilities": {
          "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities"
        }
      },
      "output": {}
    }
  ],
  "next": null
}

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
​
limit
integer
​
next
string

Response

200 - application/json

Successfully retrieved a list of jobs.

The response is of type object.