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

200 - application/json

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

Construct a type with a set of properties K of type T

​
name
string | null
required
​
submitted_at
string
required
​
started_at
string
required
​
completed_at
string
required
​
predicted_wait_time_ms
number | null
required
​
predicted_execution_duration_ms
number | null
required
​
execution_duration_ms
number | null
required
​
shots
integer
required
​
failure
object
required
​
output
object
required

Construct a type with a set of properties K of type T

​
child_job_ids
string[] | null
required
​
settings
object
required
​
stats
object
required
​
results
object
required
​
noise
object

Only present in the response when backend is simulator.