GET
/
backends
/
{backend}
cURL
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1"
{
  "backend": "qpu.aria-1",
  "status": "available",
  "degraded": true,
  "qubits": 25,
  "average_queue_time": 1181215,
  "last_updated": "2025-06-16T00:00:00Z",
  "characterization_id": "617a1f8b-59d4-435d-aa33-695433d7155e",
  "kw": 5.12345
}
Retrieve detailed information about a specific backend including its current status, qubit count, queue times, and performance characteristics. Use this to check if a backend is available before submitting jobs or to get technical specifications. Learn more about backend specifications.

Path Parameters

​
backend
enum<string>
required

A backend where jobs can run on.

Available options:
qpu.aria-1,
qpu.aria-2,
qpu.forte-1,
qpu.forte-enterprise-1

Response

200 - application/json

Successfully retrieved backend.

A backend that you can target your program to run on.

​
backend
enum<string>
required

Specifies target hardware and generation where applies.

Available options:
qpu.aria-1,
qpu.aria-2,
qpu.forte-1,
qpu.forte-enterprise-1
Example:

"qpu.aria-1"

​
status
enum<string>
required

Current availability.

Available options:
available,
unavailable
​
degraded
boolean
required

Flag to tell if the backend is degraded or not.

​
qubits
integer
required

The number of qubits available.

Required range: x >= 0
Example:

25

​
average_queue_time
number
required

Current wait time on the queue for execution.

Example:

1181215

​
last_updated
string
required

Last date time the backend status was updated.

Example:

"2025-06-16T00:00:00Z"

​
characterization_id
string

Current characterization ID for this backend

Example:

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

​
kw
number

The average amount of energy consumed by the backend represented in kilowatts.

Example:

5.12345