Skip to main content
GET
/
jobs
/
{UUID}
cURL
curl "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"
{
  "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,
  "child_job_ids": 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": {
    "compilation": {},
    "error_mitigation": {
      "debiasing": {
        "variants": [
          {
            "variant_id": "069ce8f8-f437-7d75-8000-9f5f8c3d7897",
            "qubit_map": [
              4,
              12,
              7
            ],
            "shots": 120,
            "results": {
              "probabilities": {
                "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/probabilities"
              },
              "histogram": {
                "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/histogram"
              },
              "shots": {
                "url": "/v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/shots"
              }
            }
          }
        ]
      }
    }
  }
}
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
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.

​
id
string
required
​
status
enum<string>
required
Available options:
submitted,
ready,
started,
canceled,
failed,
completed
​
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 | null
required
​
parent_job_id
string | null
required
​
session_id
string | null
required
​
metadata
object
required
​
name
string | null
required
​
submitted_at
string
required
​
started_at
string
required
​
completed_at
string
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
required
​
output
object
required
​
settings
object
required
​
stats
object
required
​
results
object
required
​
child_job_ids
string[] | null
required
​
shots
integer<int32>
​
noise
object

Only present in the response when backend is simulator.