Skip to main content
GET
/
backends
cURL
curl "https://api.ionq.co/v0.3/backends"
{
  "backend": "qpu.aria-1",
  "status": "available",
  "average_queue_time": 1181215,
  "last_updated": 1490932820,
  "degraded": false,
  "characterization_url": "/characterizations/617a1f8b-59d4-435d-aa33-695433d7155e"
}

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

​
status
enum<string>

What the system is currently doing. Note that regardless of system status, you can always submit jobs for execution.

  • running The system is running jobs.
  • reserved The system is reserved by a single customer. It will resume regular execution after the reservation is complete.
  • calibrating The system is currently calibrating and will resume regular execution when calibration is complete.
  • offline The system is currently offline and not processing jobs.

Please refer to https://status.ionq.co/ for more information.

Available options:
verbose

Response

200 - application/json

Successfully retrieved backends.

A list of backends you can target your program to run on.

​
backend
string
required

Specifies target hardware and generation where applies.

Example:

"qpu.aria-1"

​
status
required

Current availability.

Please refer to https://status.ionq.co/ for more information.

Available options:
available,
unavailable
​
average_queue_time
number<unix-timestamp>
required

Current wait time on the queue for execution.

Example:

1181215

​
last_updated
integer
required

Last time the backend status was updated.

Example:

1490932820

​
degraded
boolean

The system is in a degraded state and may be processing jobs slower than usual. Only applies to systems in running, reserved, or calibrating status.

Example:

false

​
characterization_url
string

Current characterization for this backend

Example:

"/characterizations/617a1f8b-59d4-435d-aa33-695433d7155e"