GET
/
jobs
curl "https://api.ionq.co/v0.3/jobs" \
  -H "Authorization: apiKey your-api-key"
{
  "jobs": [
    {
      "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
    }
  ],
  "next": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

Query Parameters

​
id
string<uuid>[]

If provided, will only return jobs whose UUID matches the list provided.

UUID of a job

​
status
enum<string>

If provided, will only return jobs whose status matches the one provided.

Available options:
submitted,
ready,
running,
canceled,
completed,
failed
Example:

"completed"

​
limit
integer
default:25

How many objects to return.

Required range: 1 <= x <= 25
​
next
string<uuid>

ID of next batch of resources to load.

Response

200 - application/json

Successfully retrieved a list of jobs.

Response body when requesting all or many jobs.