GET
/
backends
/
{backend}
/
characterizations
cURL
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations"
{
  "characterizations": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "date": "2025-06-16T00:00:00Z",
      "backend": "qpu.aria-1",
      "qubits": 25,
      "connectivity": [
        [
          0,
          1
        ],
        [
          0,
          2
        ],
        [
          10,
          9
        ]
      ],
      "fidelity": {
        "spam": {
          "median": 0.9962,
          "stderr": null
        }
      },
      "timing": {
        "readout": 123,
        "reset": 123,
        "1q": 123,
        "2q": 123,
        "t1": 10,
        "t2": 1
      }
    }
  ],
  "pages": 123
}
Retrieve historical performance characterizations for a specific backend with optional date filtering and pagination. Characterizations provide snapshots of quantum hardware performance including fidelity measurements and gate operation speeds over time. Learn more about backend characterizations.

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

Query Parameters

start
string

Characterizations starting at this date (e.g., start=2025-12-31)

end
string

Characterizations before or equal to this date (e.g., end=2025-12-31)

limit
integer
default:10

How many objects to return.

Required range: 1 <= x <= 10
page
integer
default:1

Specify the page of results to return.

Required range: x >= 1

Response

200 - application/json

Successfully retrieved characterizations.

Response body from requesting characterization data.