Get job

cURL

curl "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.ionq.co/v0.4/jobs/{UUID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ionq.co/v0.4/jobs/{UUID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ionq.co/v0.4/jobs/{UUID}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ionq.co/v0.4/jobs/{UUID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524",
  "status": "completed",
  "type": "ionq.circuit.v1",
  "backend": "qpu.forte-1",
  "dry_run": false,
  "submitter_id": "64b03577072d45001c85e9c4",
  "project_id": "1333d459-cf47-4a5e-acc1-8d4eb4f7b025",
  "parent_job_id": null,
  "child_job_ids": null,
  "session_id": null,
  "metadata": null,
  "name": "Bell state",
  "submitted_at": "2026-06-11T20:47:05.440Z",
  "started_at": "2026-06-11T20:47:10.000Z",
  "completed_at": "2026-06-11T20:47:15.000Z",
  "predicted_execution_duration_ms": null,
  "predicted_wait_time_ms": null,
  "execution_duration_ms": 4200,
  "shots": 1000,
  "failure": null,
  "settings": {
    "error_mitigation": {
      "debiasing": true
    }
  },
  "stats": {
    "qubits": 2,
    "circuits": 1,
    "gate_counts": {
      "1q": 4,
      "2q": 1
    }
  },
  "output": {
    "compilation": {},
    "error_mitigation": {
      "debiasing": {
        "variants": [
          {
            "variant_id": "069ce8f8-f437-7d75-8000-9f5f8c3d7897",
            "qubit_map": [
              4,
              12,
              7
            ],
            "shots": 120,
            "results": {
              "ionq.result.probabilities.json.v2": {
                "id": "06b27432-cdde-7a0f-8000-1b9e2d6a4f01",
                "format": "ionq.result.probabilities.json.v2",
                "media_type": "application/json"
              },
              "ionq.result.histogram.json.v2": {
                "id": "06b27432-cde0-78a7-8000-9c4f3b1d8e02",
                "format": "ionq.result.histogram.json.v2",
                "media_type": "application/json"
              },
              "ionq.result.shots.json.v2": {
                "id": "06b27432-cde2-7c11-8000-7a6e5d2c9f03",
                "format": "ionq.result.shots.json.v2",
                "media_type": "application/json"
              }
            }
          }
        ]
      }
    }
  },
  "results": {
    "ionq.result.probabilities.json.v2": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "format": "ionq.result.probabilities.json.v2",
      "media_type": "application/json"
    }
  }
}

GET

jobs

{UUID}

cURL

curl "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.ionq.co/v0.4/jobs/{UUID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ionq.co/v0.4/jobs/{UUID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ionq.co/v0.4/jobs/{UUID}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ionq.co/v0.4/jobs/{UUID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524",
  "status": "completed",
  "type": "ionq.circuit.v1",
  "backend": "qpu.forte-1",
  "dry_run": false,
  "submitter_id": "64b03577072d45001c85e9c4",
  "project_id": "1333d459-cf47-4a5e-acc1-8d4eb4f7b025",
  "parent_job_id": null,
  "child_job_ids": null,
  "session_id": null,
  "metadata": null,
  "name": "Bell state",
  "submitted_at": "2026-06-11T20:47:05.440Z",
  "started_at": "2026-06-11T20:47:10.000Z",
  "completed_at": "2026-06-11T20:47:15.000Z",
  "predicted_execution_duration_ms": null,
  "predicted_wait_time_ms": null,
  "execution_duration_ms": 4200,
  "shots": 1000,
  "failure": null,
  "settings": {
    "error_mitigation": {
      "debiasing": true
    }
  },
  "stats": {
    "qubits": 2,
    "circuits": 1,
    "gate_counts": {
      "1q": 4,
      "2q": 1
    }
  },
  "output": {
    "compilation": {},
    "error_mitigation": {
      "debiasing": {
        "variants": [
          {
            "variant_id": "069ce8f8-f437-7d75-8000-9f5f8c3d7897",
            "qubit_map": [
              4,
              12,
              7
            ],
            "shots": 120,
            "results": {
              "ionq.result.probabilities.json.v2": {
                "id": "06b27432-cdde-7a0f-8000-1b9e2d6a4f01",
                "format": "ionq.result.probabilities.json.v2",
                "media_type": "application/json"
              },
              "ionq.result.histogram.json.v2": {
                "id": "06b27432-cde0-78a7-8000-9c4f3b1d8e02",
                "format": "ionq.result.histogram.json.v2",
                "media_type": "application/json"
              },
              "ionq.result.shots.json.v2": {
                "id": "06b27432-cde2-7c11-8000-7a6e5d2c9f03",
                "format": "ionq.result.shots.json.v2",
                "media_type": "application/json"
              }
            }
          }
        ]
      }
    }
  },
  "results": {
    "ionq.result.probabilities.json.v2": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "format": "ionq.result.probabilities.json.v2",
      "media_type": "application/json"
    }
  }
}

Retrieve detailed information about a specific job using its unique identifier. This returns the job’s current status, execution details, results (if completed), and metadata including timing information, gate counts, and failure details if applicable. Learn more about viewing job results.

Authorizations

Authorization

string

header

default:apiKey your-api-key

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

Path Parameters

UUID

string

required

The UUID of the job — this UUID is provided in the response on job creation.

Response

Successfully retrieved a job.

Single Circuit
Multi Circuit
QAOA Function
Quantum Function

Discriminated union over the four job-type families. Tabs in the docs are grouped by these families (matching the JobCreationPayload grouping on the Create Job endpoint).

string

required

status

enum<string>

required

Available options:

submitted,

ready,

started,

canceled,

failed,

completed

type

enum<string>

required

Available options:

ionq.circuit.v1,

ionq.qasm3.v1,

ionq.qir.v1,

qctrl.qaoa-circuit.v1

backend

string

required

dry_run

boolean

required

submitter_id

string

required

The id of the user who submitted the job.

project_id

string | null

required

parent_job_id

string | null

required

session_id

string | null

required

metadata

object | null

required

Show child attributes

name

string | null

required

submitted_at

string

required

started_at

string | null

required

completed_at

string | null

required

predicted_wait_time_ms

integer<int32> | null

required

predicted_execution_duration_ms

integer<int32> | null

required

execution_duration_ms

integer<int32> | null

required

How long the job actually took to run on the QPU. Null if the job hasn't run yet.

failure

object | null

required

Show child attributes

output

object

required

Show child attributes

settings

object

required

Show child attributes

stats

object

required

Job-type-specific execution statistics. The concrete shape is determined by the job type (see the per-job-type tabs above).

Show child attributes

results

object | null

required

Result artifacts produced by the circuit, keyed by format identifier. Each entry is an ArtifactDescriptor — pass its id to the artifact endpoint to download the payload. See Results formats for the catalog of valid identifiers and their payload schemas.

Show child attributes

child_job_ids

string[] | null

required

shots

integer<int32>

shots are not included with ideal simulator backend.

noise

object

Only present in the response when backend is simulator.

Show child attributes

cost_model

enum<string>

The billing model used for this job.

Available options:

QCT,

2QGE_operations

IonQ v0.4 API

Jobs

Sessions

Backends

Utilities

Schemas

Authorizations

Path Parameters

Response