Educational Resources

Sample Notebooks

Get Help

Send Feedback

IonQ Quantum Cloud Documentation

Home

SDKs

API Reference

Sign In

Support

Cancel the execution of many jobs at once by passing a list of jobs.

Cancel many Jobs

API Key

Response body from successfully cancelling many jobs.

Learn how to create and manage your IonQ API keys for secure access through SDKs and APIs.

Managing API keys

Learn how to submit jobs directly to the IonQ API

Direct API Submissions

Things to do before submitting to IonQ's hardware systems.

QPU Submission Checklist

Getting started with IonQ's hardware-native gateset

Native Gates

SDKs allow access to IonQ resources directly from within your code environment

Overview

Quantum SDKs

Learn how to use the Qiskit SDK to submit quantum circuits to IonQ's simulators and quantum computers.

Getting started with Qiskit

Learn how to use our hardware-native gateset to run a circuit with Qiskit

Using native gates with Qiskit

Learn how to use the Cirq SDK to submit quantum circuits to IonQ's simulators and quantum computers.

Cirq

Learn how to use our hardware-native gateset to run a circuit with Cirq

Using native gates with Cirq

Learn how to use PennyLane to submit quantum circuits to IonQ's simulators and quantum computers.

PennyLane

Learn how to use our hardware-native gateset to run a circuit with PennyLane

Using native gates with PennyLane

Learn how to use TensorFlow Quantum to connect your ML workflows to IonQ's simulators and quantum computers.

TensorFlow Quantum

Your Account

Organizations

Projects are collaborative workspaces created in an organization to manage teams and resources.

Projects

Learn how to connect to IonQ products and services through AWS Braket

Amazon Braket

Enhance security and simplify user management by authenticating with your SAML-based SSO provider

Connecting a SAML Identity Provider

Introduction

API Core Concepts

Writing Quantum Programs

Migrating from old API versions

This guide covers everything from setting up a multicircuit job, submitting it to IonQ's backend, and retrieving the results.

Multicircuit Jobs

Learn how to use our hardware-native gateset to run a circuit with the IonQ API

Using native gates with the IonQ API

**NOTE**: If request filters are provided, this endpoint will limit responses to 1 or more specific jobs based on those filters.<br /><br />
This endpoint retrieves all jobs this API key is authorized to view.


Get Jobs

To submit a program to be simulated or executed on our quantum hardware, `POST` it to the `jobs` endpoint.

Create a Job

Permanently remove many jobs from our platform. This cannot be undone.

Delete many Jobs

Get a specific Job

Permanently delete a job from our service. This cannot be undone.

Delete a Job

Retrieve a specific job's results by UUID.

Get a Job's output

Cancel the execution of a single job by ID.

Cancel a Job

This endpoint retrieves an array of all available backend characterizations, with pagination.

Get All Backend Characterizations

This endpoint retrieves the most recent backend characterization data available.

Get the Most Recent Backend Characterization

This endpoint retrieves a characterization.

Get a Characterization

Retrieve a list of all available backends.

Get Backends

Get a usage report for the given organization from the start_date and end_date, detailing how much usage went to each QPU during that period. If no start_date or end_date are provided, period defaults to last 30 days until current time.

IonQ APIs

Jobs

Characterizations

Backends

Reports

Cancel many Jobs

Authorizations

Body

Response