Skip to main content
GET
/
backends
/
{backend}
cURL
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1"

{
  "average_queue_time": 1181215,
  "backend": "qpu.aria-1",
  "last_updated": "2025-06-16T00:00:00Z",
  "qubits": 25,
  "status": "<string>",
  "characterization_id": "617a1f8b-59d4-435d-aa33-695433d7155e",
  "degraded": true,
  "kw": 4902.81,
  "location": "College Park, MD, USA",
  "supported_error_mitigations": [
    "debiasing"
  ],
  "supported_gates": [
    "x",
    "y",
    "z",
    "h",
    "s",
    "si",
    "t",
    "ti",
    "v",
    "vi",
    "rx",
    "ry",
    "rz",
    "cnot",
    "swap",
    "xx",
    "yy",
    "zz",
    "not"
  ],
  "supported_native_gates": [
    "gpi",
    "gpi2",
    "ms"
  ]
}
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,
qpu.forte-enterprise-2,
qpu.forte-enterprise-3

Response

200 - application/json

Successfully retrieved backend.

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

​
average_queue_time
number<unix-timestamp>
required

Current wait time on the queue for execution.

Example:

1181215

​
backend
string
required

Specifies target hardware and generation where applies: simulator, qpu.aria-1, qpu.aria-2, qpu.forte-1, qpu.forte-enterprise-1, qpu.forte-enterprise-2, qpu.forte-enterprise-3

Example:

"qpu.aria-1"

​
last_updated
string
required

Last date time the backend status was updated.

Example:

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

​
qubits
integer
required

The number of qubits available.

Required range: x >= 0
Example:

25

​
status
string
required

Current status of the backend: available, unavailable, retired.

​
characterization_id
string

Current characterization ID for this backend

Example:

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

​
degraded
boolean

Flag to tell if the backend is degraded or not.

​
kw
number<double>

The amount of energy used by the backend in kilowatt-hours.

Example:

4902.81

​
location
string

The location of the backend.

Example:

"College Park, MD, USA"

​
supported_error_mitigations
string[]

Error mitigation options supported by the backend.

Example:
["debiasing"]
​
supported_gates
string[]

Gates supported by the backend.

Example:
[
  "x",
  "y",
  "z",
  "h",
  "s",
  "si",
  "t",
  "ti",
  "v",
  "vi",
  "rx",
  "ry",
  "rz",
  "cnot",
  "swap",
  "xx",
  "yy",
  "zz",
  "not"
]
​
supported_native_gates
string[]

Native gates supported by the backend.

Example:
["gpi", "gpi2", "ms"]