GET
/
jobs
/
{UUID}
curl "https://api.ionq.co/v0.2/jobs/617a1f8b-59d4-435d-aa33-695433d7155e" \
  -H "Authorization: apiKey your-api-key"
{
  "id": "aa54e783-0a9b-4f73-ad2f-63983b6aa4a8",
  "type": "circuit",
  "name": "My Awesome Job",
  "status": "completed",
  "target": "qpu.harmony",
  "noise": {
    "model": "harmony",
    "seed": 100
  },
  "data": {
    "histogram": {
      "0": 0.5,
      "1": 0.5,
      "2": 1e-7
    }
  },
  "metadata": {
    "custom_key": "a string, maximum 400 chars"
  },
  "shots": 123,
  "gate_counts": {
    "1q": 8,
    "2q": 2
  },
  "qubits": 4,
  "request": 1490932820,
  "start": 1490932821,
  "response": 1490932834,
  "execution_time": 13,
  "predicted_execution_time": 13,
  "failure": {
    "error": "An error occurred!",
    "code": "internal_error"
  },
  "warning": {
    "messages": [
      "<string>"
    ]
  }
}

Authorizations

Authorization
string
headerrequired

We provide API keys to govern access—we'll provision your account with one key, and more can be provided upon request.

Every key is fully privileged within the system, and should be kept private.

To authenticate, prefix your API Key with apiKey and place it in the Authorization request header. For example: 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.

Query Parameters

exclude
string[]

Exclude certain fields from the response (e.g., exclude=status,device_id).

include
string[]

Only return the provided fields (e.g., include=status,device_id).

Response

200 - application/json
id
string
required

The UUID of a job. We'll provide the UUID initially in our response to a job creation request.

type
enum<string>
required

The job type

Available options:
circuit
name
string

A job name.

status
enum<string>
required

Status of a job.

Available options:
submitted,
ready,
running,
canceled,
completed,
failed
target
enum<string>
default: simulator

Target hardware for job to run on.

Available options:
qpu.harmony,
qpu.aria-1,
simulator
noise
object

When the target is "simulator", this field specifies optional noise parameters for simulation. (If these noise parameters are not provided, simulations will run on an ideal quantum computer model, without noise.) This field does not apply to qpu.* targets.

data
object

Job execution data.

metadata
object

User defined metadata.

shots
number
default: 100

How many times to execute your circuit when submitting to a QPU or a "non-ideal" noisy simulator.

gate_counts
object

The number of gates used with this job.

qubits
integer

The number of qubits used with this job.

request
integer
required

The point in time this job was requested.

start
integer

The point in time this job was started.

response
integer

The point in time this job was completed.

execution_time
integer

The actual execution time of this job.

predicted_execution_time
integer

The predicted execution time of this job.

failure
object

Error metadata, if the job failed.

warning
object

Warning metadata, if a warning is necessary.