GET
/
backends
/
{backend}
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"
}

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.

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

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.