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

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.

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

Successfully retrieved a job

A quantum job.

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

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.

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

Successfully retrieved a job

A quantum job.